C++的std::source_location是什么_C++20在编译期获取源码位置信息的利器

新闻中心 NEWS CENTER

您当前位置：首页 > 新闻中心 > 网络学院

C++的std::source_location是什么_C++20在编译期获取源码位置信息的利器

2025-12-04

浏览次数：次

返回列表

std::source_location是C++20引入的用于获取源码位置信息的工具，定义于头文件中，可自动捕获文件名、行号、列号和函数名。1. 它通过编译器在调用点填充信息，无需宏或运行时解析，开销小且支持constexpr。2. 常见用法是作为带默认值的函数参数，如日志函数中自动记录位置。3. 可在编译期使用current()获取位置，适用于模板元编程和静态检查。4. 需C++20支持，GCC 11+、Clang 13+、MSVC 19.29+可用；file_name()返回路径依赖编译选项，建议避免长期存储对象以防跨单元问题。该工具减少手动使用__FILE__、__LINE__的重复代码，提升调试与日志效率。

c++的std::source_location是什么_c++20在编译期获取源码位置信息的利器

std::source_location 是 C++20 引入的一个实用工具，它允许你在运行时或编译期获取代码的源码位置信息，比如文件名、函数名、行号等。这个功能在日志记录、调试输出和断言处理中非常有用，能显著提升错误追踪效率。

什么是 std::source_location

std::source_location 是定义在头文件中的一个类，它封装了当前代码的位置信息。这些信息包括：

文件路径（file_name）
行号（line）
列号（column）
函数名（function_name）

关键在于，这些值不是通过宏或运行时堆栈解析获得的，而是由编译器在调用点自动填充的，因此开销极小，且支持在 constexpr 上下文中使用。

如何使用 std::source_location

最常见的使用方式是将其作为函数参数，默认值由编译器自动提供。例如：

#include <iostream>
#include <source_location>

void log(const std::string& msg,
         const std::source_location& loc = std::source_location::current())
{
    std::cout << "文件: " << loc.file_name() << "\n"
              << "行号: " << loc.line() << "\n"
              << "函数: " << loc.function_name() << "\n"
              << "消息: " << msg << "\n\n";
}

void test_function() {
    log("这是一条测试日志");
}

当你调用 log 而不传递第二个参数时，编译器会自动填入调用处的位置信息。输出结果会显示实际的文件名、行号和函数名。

在编译期获取位置信息

因为 std::source_location::current() 是 constexpr 函数，你可以在编译期捕获源码位置。这使得它可用于模板元编程或静态断言增强场景。

例如，你可以设计一个编译期诊断工具：

星辰Agent

科大讯飞推出的智能体Agent开发平台，助力开发者快速搭建生产级智能体

378 查看详情星辰Agent

template<typename T>
constexpr void validate_type(std::source_location loc = std::source_location::current()) {
    static_assert(std::is_integral_v<T>, "T 必须是整型");
    // 其他编译期检查逻辑
}

虽然 assert 不适用于 constexpr，但你可以结合 if-consteval 或其他条件逻辑做差异化处理。