c++oding="utf-8" ?>
std::source_location是c++20引入的编译期源码位置捕获结构体，用于日志中精准定位调用点；需通过宏默认参数自动填充，不可手动构造或转发，配合basename截取文件名可实现轻量高效日志定位。
std::source_location 是什么，为什么日志里需要它
std::source_location 是 C++20 引入的轻量结构体，用于在编译期捕获调用点的源码位置信息（文件名、行号、函数名、列号）。它不依赖运行时栈回溯或宏展开技巧，开销极低，且类型安全。日志中嵌入它，能直接定位到 LOG_INFO("user logged in") 这一行，而不是日志函数内部某行。
注意：它必须在调用点由编译器自动填充，不能手动构造（C++20 标准禁止用户显式调用 std::source_location::current() 来“伪造”位置——虽然某些编译器允许，但行为未定义）。
如何在日志宏中正确传入 source_location
最常见错误是把 std::source_location 当作普通参数传递，却忘了它必须由编译器隐式提供：
- ✅ 正确写法：用默认参数，在宏里触发编译器填充
- ❌ 错误写法：在调用处手动写
std::source_location::current()，或试图从函数参数“转发”它（会丢失原始调用点）
#define LOG_DEBUG(msg)
do {
logger_debug(msg, std::source_location::current());
} while(0)
<p>void logger_debug(const char* msg, const std::source_location& loc) {
fprintf(stderr, "[%s:%d] %s
",
loc.file_name(), loc.line(),
msg);
}</p>
关键点：
- 宏展开后，
std::source_location::current()在调用宏的源码行执行，位置准确 - 函数参数用
const std::source_location&接收，避免拷贝（虽小但语义清晰） - 不要用
auto loc = std::source_location::current()在函数体内——那记录的是函数第一行，不是调用点
file_name() 返回的路径太长，怎么只取文件名
std::source_location::file_name() 返回完整路径（如 "/home/user/proj/src/main.cpp"），日志里通常只需 "main.cpp"。C++20 没提供内置 basename，得自己截取：
- 最简单可靠方式：从后往前找最后一个
'/'或''（Windows 兼容） - 不要依赖
std::filesystem::path—— 它可能引入额外开销和异常，且部分嵌入式/旧工具链不支持
inline const char* basename(const char* path) {
const char* last_slash = nullptr;
for (const char* p = path; *p; ++p) {
if (*p == '/' || *p == '\') last_slash = p + 1;
}
return last_slash ? last_slash : path;
}
<p>// 用法：
fprintf(stderr, "[%s:%d] %s
",
basename(loc.file_name()), loc.line(),
msg);</p>
注意：
-
file_name()返回const char*，指向静态存储期字符串，无需担心生命周期 - 不要用
std::string包装再调.filename().c_str()——多一次分配，且可能抛异常
不同编译器对 source_location 的支持和行为差异
GCC 10+、Clang 12+、MSVC 19.29+ 支持 std::source_location，但细节有差别：
- GCC 默认启用，无需额外 flag；Clang 需
-std=c++20（-std=gnu++20也行） - MSVC 在 /std:c++20 下可用，但
function_name()可能返回空字符串（取决于调试信息开关） - 所有编译器都保证
file_name()和line()准确，这是标准强制要求 - 如果用了预编译头（PCH），
file_name()可能显示 PCH 文件名——这不是 bug，而是宏展开发生在 PCH 包含之后；解决办法是把日志宏定义放在 PCH 之后，或确保宏在用户源文件中展开
实际项目中，建议加编译期检查：
#if __cpp_lib_source_location <p><code>std::source_location</code> 看似简单，但它的价值完全依赖宏的正确包裹方式；漏掉宏、手动生成、或跨函数传递，都会让位置信息失效——而这恰恰是最难 debug 的问题：日志写着 “xxx.cpp:42”，结果你打开一看，那行根本不是你打的日志。</p>
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
