std::source_location可获取文件名、函数名、行号和列号;提供file_name()、function_name()、line()、column()四个只读成员函数,常通过默认参数隐式生成用于日志调试。

std::source_location 是 C++20 引入的一个轻量级工具类,用于在编译期自动捕获当前代码的源文件名、函数名、行号和列号,无需手动传参或宏拼接,特别适合日志、断言、调试和错误追踪场景。
它能获取哪些信息?
每个 std::source_location 实例包含四个只读成员函数:
-
file_name():返回 const char*,通常是完整路径(如
/home/user/proj/main.cpp) -
function_name():返回 const char*,一般是编译器生成的函数签名(如
void test_func()或int main()) - line():返回 unsigned int,调用点所在行号(从 1 开始)
- column():返回 unsigned int,调用点所在列号(通常从 1 开始,但部分编译器可能为 0)
怎么用?最简实践方式
它不支持运行时构造,必须由编译器在调用点隐式生成,默认参数是它的典型用法:
void log(const char* msg, std::source_location loc = std::source_location::current()) {
std::cout << "[" << loc.file_name() << ":" << loc.line()
<< "] " << loc.function_name() << " - " << msg << "\n";
}
// 调用时完全不用传 loc 参数
log("something went wrong"); // 自动捕获调用位置
注意:std::source_location::current() 是静态成员函数,必须在函数体内调用才能获得该处的位置——不能提前存起来再传,否则捕获的是 current() 所在行,不是调用行。
立即学习“C++免费学习笔记(深入)”;
常见注意事项
- 不是所有编译器默认开启 C++20 支持,需显式启用:GCC/Clang 加
-std=c++20,MSVC 用/std:c++20 - 函数名内容依赖编译器实现,可能含模板参数、匿名命名空间修饰等,不适合做字符串匹配,仅作显示或调试用
- 不参与 ABI,可安全用于头文件中的内联函数、模板函数,无链接或二进制兼容问题
- 开销极小,几乎等价于几个常量地址加载,比
__FILE__+__LINE__宏更类型安全、易扩展
对比传统宏方案
过去常用 #define LOG(msg) printf("[%s:%d] %s\n", __FILE__, __LINE__, msg),但存在明显缺陷:
- 无法获取函数名(除非额外加
__func__,且类型不统一) - 宏展开后丢失作用域信息,调试器难追踪
- 类型不安全,容易误用;无法作为函数参数自然传递
- 与模板、constexpr 不友好
而 std::source_location 是标准、类型安全、零成本抽象的现代替代方案。
基本上就这些。用好它,能让调试信息更准、日志更清晰,还不用自己拼宏。











