std::source_location是C++20引入的用于自动捕获文件名、行号、函数名和列号的工具,适用于日志、调试和错误报告。通过std::source_location::current()获取调用点信息,需在作用域内直接调用以确保位置准确。其file_name()、line()、function_name()等成员函数可提取上下文信息,但function_name()依赖编译器符号支持,可能返回空或修饰名。使用时需启用C++20标准,且注意封装过深可能导致位置记录偏差。该工具提升代码可维护性,减少手动传参,增强诊断能力。

std::source_location 是 C++20 引入的一个实用工具,定义在
std::source_location 的主要用途
当你需要在不手动输入位置信息的情况下,打印或记录代码执行点时,std::source_location 就非常有用。例如,在写一个通用的日志函数时,你可能希望每条日志都自动带上触发它的文件和行号。传统做法是用宏(如 __FILE__ 和 __LINE__),但 std::source_location 提供了类型安全且更简洁的方式。
基本使用方法
std::source_location 通常通过静态成员函数 std::source_location::current() 获取当前调用点的信息。由于该函数是隐式调用的,必须在目标作用域内直接调用才能正确捕获位置。
示例:
立即学习“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 使用方便,但也有一些需要注意的地方:
- 捕获的位置是 std::source_location::current() 被调用的那一行,因此如果封装过深而没有将 source_location 向下传递,可能会记录错误的位置。
- function_name() 的内容依赖于编译器能否获取符号信息,某些情况下可能为空或为修饰名(mangled name)。
- 必须启用 C++20 支持(如 GCC 10+ 或 Clang 13+,并加上 -std=c++20 编译选项)。
基本上就这些。std::source_location 让日志和诊断信息变得更智能,减少了重复传参的麻烦,提升了代码可维护性。用好它,调试效率会明显提升。











