C++ std::source_location 自动化记录日志源码位置 _ 调试技巧【详解】-C++-PHP中文网

std::source_location可自动捕获调用点文件名、行号和函数名：一、通过默认参数绑定实现零侵入日志；二、封装宏确保位置信息在调用处生成；三、结合std::format提升类型安全性；四、添加noinline属性保障调试信息准确；五、提供c++20降级兼容方案。

c++ std::source_location 自动化记录日志源码位置 _ 调试技巧【详解】

如果您在调试 C++ 程序时希望日志自动携带调用点的文件名、行号、函数名等上下文信息，而无需手动传入宏参数，则 std::source_location 可提供编译期自动捕获能力。以下是实现该功能的具体方法：

一、使用默认参数绑定 std::source_location

通过将 std::source_location 设为函数的默认参数，编译器会在每次调用处自动注入当前源码位置信息，无需显式传递。

1、定义日志函数，声明 source_location 为最后一个默认参数：
void log(const char* msg, const std::source_location& loc = std::source_location::current());

2、在函数体内提取文件路径、行号与函数名：
const char* file = loc.file_name();
int line = loc.line();
const char* func = loc.function_name();

3、组合输出格式，例如：fprintf(stderr, "[%s:%d %s] %s\n", file, line, func, msg);

二、封装为宏以支持表达式求值与多参数日志

宏可确保 source_location 在调用点而非函数内部生成，并能配合可变参数实现灵活日志格式。

1、定义宏 LOG，利用 __VA_ARGS__ 转发参数并强制插入当前 location：
#define LOG(...) ::detail::log_impl(__FILE__, __LINE__, __func__, __VA_ARGS__)

2、编写 detail::log_impl 辅助函数，接收显式传入的文件、行、函数名及可变参数：
template
void log_impl(const char* file, int line, const char* func, const char* fmt, Args&&... args);

3、在实现中调用 vsnprintf 或 fmt::format 构造完整消息字符串，再统一输出至 stderr 或日志缓冲区。

三、结合 std::format 实现类型安全的日志格式化

利用 C++20 std::format 替代 C 风格 printf，避免格式符错误，同时保持 source_location 的自动注入特性。

1、声明日志函数接受 std::format_string 和其参数包：
template
void log(std::format_string fmt, Args&&... args);

C函数速查手册（CHM版）

下载

2、在函数体内调用 std::source_location::current() 获取调用点信息：
auto loc = std::source_location::current();

3、构造带位置前缀的格式串并执行格式化：
auto prefix = std::format("[{}:{} {}] ", loc.file_name(), loc.line(), loc.function_name());
auto full_msg = std::format(prefix + std::string{fmt}, std::forward(args)...);