17370845950

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

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