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

std::source_location 是 C++20 引入的一个轻量级工具,用于在运行时获取源代码中的位置信息,比如文件名、行号、函数名和列号。它属于头文件
std::source_location 能获取哪些信息?
通过 std::source_location,你可以访问以下信息:
- 文件路径(file_name):源文件的完整或相对路径。
- 行号(line):当前所在的行号,从 1 开始计数。
- 列号(column):当前所在的列号,通常从 1 开始(部分编译器可能不支持,返回 0)。
- 函数名(function_name):所在函数的名称,通常是经过修饰的字符串(mangled name),但可读性比宏定义强。
如何使用 std::source_location?
最常见的用法是作为函数参数,默认捕获调用点的位置。由于其构造函数被声明为 consteval,它在编译期就能确定值,不会带来运行时性能开销。
示例代码:
立即学习“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 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 中处理调试、日志、断言等场景下获取源码位置的标准方法,简洁、高效、类型安全,推荐替代传统的宏方式。











