C++20标准新增的std::source_location是一个工具类，能够在不依赖宏定义的情况下，获取当前代码所在的文件名、函数名、行号、列号等位置信息，非常适合用来实现日志定位功能，解决了传统宏定义实现日志定位时的各类弊端。
std::source_location基础介绍
std::source_location定义在<source_location>头文件中，它有几个核心的静态成员函数和一个默认构造函数，常用的成员函数如下：
- current()：静态成员函数，返回表示当前调用位置信息的std::source_location对象
- file_name()：返回当前代码所在的文件名，类型为const char*
- function_name()：返回当前代码所在的函数名，类型为const char*
- line()：返回当前代码所在的行号，类型为uint_least32_t
- column()：返回当前代码所在的列号，类型为uint_least32_t
传统宏定义实现日志定位的问题
在C++20之前，开发者通常会用__FILE__、__LINE__、__FUNCTION__等预定义宏来实现日志定位，示例代码如下：
#include <iostream>
#include <string>
// 宏定义日志输出
#define LOG_MACRO(msg)
std::cout << "[" << __FILE__ << ":" << __LINE__ << "][" << __FUNCTION__ << "] " << msg << std::endl
void test_func() {
LOG_MACRO("这是宏定义的日志");
}
int main() {
LOG_MACRO("主函数中的日志");
test_func();
return 0;
}
这种实现方式存在几个明显的问题：
- 宏定义没有作用域限制，容易造成命名冲突
- 宏是文本替换，没有类型检查，容易引发隐蔽的bug
- 宏的展开逻辑复杂，调试时难以追踪问题
- 无法直接传递位置信息到普通函数中，只能嵌入到宏的内部逻辑里
用std::source_location替代宏定义实现日志定位
std::source_location可以作为函数参数传递，我们可以将日志输出封装成一个普通函数，通过参数传入位置信息，完全替代宏定义的作用。首先看一个简单的日志函数实现：
#include <iostream>
#include <source_location>
#include <string>
// 日志输出函数，默认参数获取调用位置的信息
void log(const std::string& msg,
const std::source_location& loc = std::source_location::current()) {
std::cout << "[" << loc.file_name() << ":" << loc.line() << "]"
<< "[" << loc.function_name() << "] "
<< msg << std::endl;
}
void test_func() {
log("这是std::source_location实现的日志");
}
int main() {
log("主函数中的日志");
test_func();
return 0;
}
上述代码中，log函数的第二个参数使用了std::source_location::current()作为默认值，调用log函数时不需要手动传递位置信息，current()会自动捕获调用log的位置，输出的日志信息和宏定义版本一致，但完全避免了宏定义的问题。
进阶用法：支持不同日志级别
我们可以扩展日志函数，增加日志级别的支持，让日志功能更完善：
#include <iostream>
#include <source_location>
#include <string>
// 日志级别枚举
enum class LogLevel {
DEBUG,
INFO,
WARN,
ERROR
};
// 日志级别转字符串
const char* level_to_string(LogLevel level) {
switch(level) {
case LogLevel::DEBUG: return "DEBUG";
case LogLevel::INFO: return "INFO";
case LogLevel::WARN: return "WARN";
case LogLevel::ERROR: return "ERROR";
default: return "UNKNOWN";
}
}
// 带级别的日志函数
void log(LogLevel level, const std::string& msg,
const std::source_location& loc = std::source_location::current()) {
std::cout << "[" << level_to_string(level) << "]"
<< "[" << loc.file_name() << ":" << loc.line() << "]"
<< "[" << loc.function_name() << "] "
<< msg << std::endl;
}
void test_func() {
log(LogLevel::INFO, "测试函数的信息日志");
log(LogLevel::WARN, "测试函数的警告日志");
}
int main() {
log(LogLevel::DEBUG, "主函数的调试日志");
test_func();
log(LogLevel::ERROR, "主函数的错误日志");
return 0;
}
std::source_location使用注意事项
- std::source_location是C++20引入的特性，需要编译器支持C++20及以上标准，比如GCC 11+、Clang 12+、MSVC 2019 16.10+版本
- std::source_location::current()的捕获位置是调用它的函数的位置，如果是在函数内部调用current()再传递出去，需要注意位置是否符合预期
- 不要将std::source_location对象作为全局变量初始化，因为全局变量的初始化顺序不确定，可能导致获取的位置信息不准确
- std::source_location的成员函数返回的字符串指针，其生命周期和对应的std::source_location对象一致，不要长期保存这些指针避免悬垂引用
两种实现方式对比
我们将宏定义和std::source_location的实现方式进行对比，方便开发者选择：
| 对比项 | 宏定义实现 | std::source_location实现 |
|---|---|---|
| 类型安全 | 无，文本替换无类型检查 | 有，作为普通函数参数，有类型检查 |
| 作用域 | 全局生效，易冲突 | 遵循函数作用域规则，无冲突问题 |
| 调试难度 | 高，宏展开逻辑复杂 | 低，普通函数调试逻辑清晰 |
| 可扩展性 | 低，扩展需要修改宏定义 | 高，普通函数可以随意扩展功能 |
| 标准支持 | C++98及以上即可 | 需要C++20及以上标准 |
综合来看，只要项目支持C++20标准，优先使用std::source_location替代宏定义实现日志定位，能大幅提升代码的质量和可维护性。
std::source_locationC++日志定位宏定义替代修改时间：2026-06-21 13:51:43