std::source_location是C++20引入的编译期源码位置捕获结构体,能替代__FILE__和__LINE__宏,但必须作为带默认值的函数参数(= std::source_location::current())在调用点由编译器隐式填充,否则会记录函数自身定义位置而非真实调用点。

std::source_location 是什么,它能直接替代 __FILE__ 和 __LINE__ 吗?
std::source_location 是 C++20 引入的标准设施,用于在编译期捕获调用点的源码位置(文件、函数、行号、列号)。它不是宏,而是一个可拷贝、可传递的结构体,比 __FILE__ 和 __LINE__ 更类型安全、更灵活——但不能“直接替代”,因为它的值必须由编译器在调用点隐式生成,不能手动构造或跨函数传播后仍保持原始位置。
常见错误是写成这样:
std::source_location
- 参数类型必须是
std::source_location(不能是 const 引用,否则某些编译器可能无法正确推导) - 默认值只能是
std::source_location::current(),不能是变量或 constexpr 表达式 - 如果函数还接收可变参数(如格式化字符串),需确保
std::source_location在所有可变参数之后
示例:
std::source_location
- 不要写
spdlog::info("msg")—— 它用的是自己的宏(如SPDLOG_FMT_STRING),和std::source_location无关 - 若封装自己的日志接口,必须把
std::source_location作为参数透传,并在格式化时显式使用loc.file_name()、loc.line()等字段 - 注意
file_name()返回的是const char*,路径可能含完整绝对路径,生产环境常需截取 basename;function_name()在 GCC/Clang 下可能为空或为 mangled 名,MSVC 支持较好
简化的兼容封装示例:
template<typename... args>
void debug(fmt::format_string<args...> fmt, Args&&... args) {
auto loc = std::source_location::current();
fmt::print("[{}:{}] {}",
std::filesystem::path(loc.file_name()).filename().string(),
loc.line(),
fmt::format(fmt, std::forward<args>(args)...));
}</args></args...></typename...>
哪些编译器和标准模式下能用?
std::source_location 要求 C++20 支持,且编译器需实现该特性。实际使用中容易踩坑的是:
- GCC 10+ 默认不启用 C++20,需显式加
-std=c++20(-std=gnu++20也可) - Clang 11+ 支持,但 Apple Clang 13.1 之前有 bug:
function_name()总返回空字符串 - MSVC 19.29+(VS 2019 16.11+)支持完整,包括未 mangled 的函数名
- 启用
-g不影响source_location工作——它是编译期机制,与调试符号无关
如果你的构建系统尚未统一升级到 C++20,临时方案仍是 __FILE__ 和 __LINE__ 宏组合,但要注意宏展开顺序和多级内联导致的位置偏移问题。
真正麻烦的不是怎么写,而是当你的日志被封装进模板函数、lambda 或 inline 函数里时,std::source_location::current() 捕获的永远是“最外层直接调用点”——这个行为没法绕过,得靠设计约束调用方式。
C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!











