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

std::source_location 是 C++20 引入的一个实用工具,它允许你在运行时或编译期获取代码的源码位置信息,比如文件名、函数名、行号等。这个功能在日志记录、调试输出和断言处理中非常有用,能显著提升错误追踪效率。
什么是 std::source_location
std::source_location 是定义在
- 文件路径(file_name)
- 行号(line)
- 列号(column)
- 函数名(function_name)
关键在于,这些值不是通过宏或运行时堆栈解析获得的,而是由编译器在调用点自动填充的,因此开销极小,且支持在 constexpr 上下文中使用。
如何使用 std::source_location
最常见的使用方式是将其作为函数参数,默认值由编译器自动提供。例如:
立即学习“C++免费学习笔记(深入)”;
#include#include 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 函数,你可以在编译期捕获源码位置。这使得它可用于模板元编程或静态断言增强场景。
例如,你可以设计一个编译期诊断工具:
templateconstexpr void validate_type(std::source_location loc = std::source_location::current()) { static_assert(std::is_integral_v , "T 必须是整型"); // 其他编译期检查逻辑 }
虽然 assert 不适用于 constexpr,但你可以结合 if-consteval 或其他条件逻辑做差异化处理。
注意事项与兼容性
使用 std::source_location 需要编译器支持 C++20,并启用相应标准。GCC 11+、Clang 13+ 和 MSVC 19.29+ 均已支持。
注意:file_name() 返回的是编译时的路径字符串字面量,通常不含绝对路径,具体取决于编译选项。某些情况下可能需要配置编译器以保留完整路径。
另外,不要将 source_location 对象长期存储,因为它持有的是字符指针,虽然指向的是静态字符串,但在不同编译单元间传递需谨慎。
基本上就这些。std::source_location 简洁高效,让日志和诊断信息自带“出处”,大大减少了手动写 __FILE__、__LINE__ 的重复劳动,是现代 C++ 提升开发体验的重要补充。










