17370845950

std::source_location可获取文件名、行号、列号和函数名，通过默认参数捕获调用位置，提供类型安全的日志与调试支持，取代传统宏，需C++20及现代编译器支持。

std::source_location 是 C++20 引入的一个轻量级工具，用于在运行时获取源代码中的位置信息，比如文件名、行号、函数名和列号。它属于头文件 ，是标准化的获取调用上下文位置的方式，取代了过去依赖宏如 __FILE__、__LINE__ 等的手动写法。

std::source_location 能获取哪些信息？

通过 std::source_location，你可以访问以下信息：

• 文件路径（file_name）：源文件的完整或相对路径。
• 行号（line）：当前所在的行号，从 1 开始计数。
• 列号（column）：当前所在的列号，通常从 1 开始（部分编译器可能不支持，返回 0）。
• 函数名（function_name）：所在函数的名称，通常是经过修饰的字符串（mangled name），但可读性比宏定义强。

如何使用 std::source_location？

最常见的用法是作为函数参数，默认捕获调用点的位置。由于其构造函数被声明为 consteval，它在编译期就能确定值，不会带来运行时性能开销。

示例代码：

#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 foo() {
    log("进入 foo 函数");
}

int main() {
    log("程序开始");
    foo();
    return 0;
}

输出会显示每次调用 log 时的实际文件、行号和函数名，无需手动传入 __FILE__ 或 __LINE__。

与传统宏相比的优势

过去我们常这样写日志：

#define LOG(msg) \
    std::cout << "文件:" << __FILE__ << " 行:" << __LINE__ << " " << msg << "\n"

这种方式虽然有效，但存在几个问题：

• 宏作用域复杂，容易出错。
• 不能作为普通函数参数传递，类型不安全。
• 函数名需要额外使用 __func__，且不在标准统一结构中。

而 std::source_location 提供了类型安全、可组合、更清晰的接口。它能嵌入到类、模板、函数参数中，适合现代 C++ 编程习惯。

注意事项和兼容性

尽管功能强大，但使用时需注意：

• 需要编译器支持 C++20，GCC 10+、Clang 10+、MSVC 19.29+ 基本可用。
• column() 可能不被所有编译器支持，返回值可能是 0。
• function_name() 返回的是编译器生成的函数签名，可能包含模板信息，较长但准确。
• 不要试图在非默认参数位置使用 .current()，会导致捕获错误的位置。

基本上就这些。std::source_location 是 C++20 中处理调试、日志、断言等场景下获取源码位置的标准方法，简洁、高效、类型安全，推荐替代传统的宏方式。