std::source_location是C++20中用于自动获取源码位置信息的类，包含文件名、行号、函数名等，通过std::source_location::current()默认参数实现日志、断言等场景的自动上下文记录，提升调试效率与代码可维护性。
在C++20中，std::source_location 提供了一种无需宏或手动输入即可自动获取代码位置信息的方法。它常用于日志记录、调试输出和错误报告，能自动捕获文件名、行号、函数名等上下文信息，极大提升了开发效率。
std::source_location 是什么？
std::source_location 是
- 文件路径（file_name）
- 行号（line）
- 列号（column）— 通常支持有限
- 函数名（function_name）
这些信息在编译时自动生成，不需要程序员手动填写。
如何使用 std::source_location
最常见的用法是将 std::source_location::current() 作为函数参数，默认传递，这样调用时无需显式传参。
立即学习“C++免费学习笔记（深入）”；
示例：打印调试信息
#include <iostream>
#include <source_location>
#include <string>
void log_debug(const std::string& message,
const std::source_location& loc = std::source_location::current())
{
std::cout << "文件: " << loc.file_name() << "\n"
<< "行号: " << loc.line() << "\n"
<< "函数: " << loc.function_name() << "\n"
<< "消息: " << message << "\n\n";
}
void some_function() {
log_debug("进入函数处理");
}
调用 some_function() 时，输出类似：
文件: main.cpp 行号: 12 函数: some_function 消息: 进入函数处理
实际应用场景
利用 std::source_location 可以增强日志系统和断言机制的实用性。
- 日志系统集成：自动标注每条日志来自哪个文件和函数，方便追踪问题。
- 自定义断言：当条件失败时，打印出错位置。
- 性能监控：记录函数执行起点和耗时，并标记来源。
例如，实现一个简单的断言宏替代：
void debug_assert(bool condition, const std::string& msg = "",
const std::source_location& loc = std::source_location::current())
{
if (!condition) {
std::cerr << "断言失败！\n"
<< "文件: " << loc.file_name() << "\n"
<< "行号: " << loc.line() << "\n"
<< "函数: " << loc.function_name() << "\n"
<< "说明: " << msg << "\n";
std::terminate();
}
}
使用方式简洁：
debug_assert(ptr != nullptr, "指针不能为空");
失败时会自动显示调用位置。
注意事项与限制
std::source_location 虽然方便，但有几点需要注意：
- 仅 C++20 及以上版本支持
- 函数名可能包含编译器修饰符号（如 GCC 的 _Z 开头），可借助 c++filt 工具解析
- 不能跨线程传递保证有效性（但数据是拷贝的，通常安全）
- column() 信息在多数编译器中不准确或固定为 0
基本上就这些。合理使用 std::source_location，可以让调试信息更智能，减少手动维护位置信息的负担，提升代码可维护性。
