c++中的std::source_location是什么_c++ C++20获取源码位置信息【调试】

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++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 是标准、类型安全、零成本抽象的现代替代方案。

基本上就这些。用好它,能让调试信息更准、日志更清晰,还不用自己拼宏。