__func__ 和 __LINE__ 是 C++11 起标准内置标识符,分别展开为函数名字符串和行号整数,零开销、作用域内有效;__func__ 是 const char[],不可 undef,__LINE__ 支持 constexpr;注意避免类型误用、跨函数传递错误及宏调试问题,C++20 推荐优先使用 std::source_location。

用 __func__ 和 __LINE__ 获取函数名与行号
标准 C++(C++11 起)直接支持这两个内置标识符,无需头文件或宏定义。它们在编译期展开为字符串字面量和整数字面量,零开销、无运行时依赖。
常见误用是试图把 __func__ 当作变量传给 std::string 构造函数却不加括号,导致类型不匹配;或者误以为它能跨函数传递——它只在定义它的作用域内有效。
-
__func__是隐式声明的局部静态 const char[],不是宏,不可被 #undef;C++11 标准保证其存在,兼容性极好 -
__LINE__是整型常量,可直接参与 constexpr 计算,比如做日志 ID 偏移 - 在模板函数中使用时,
__func__展开的是实例化后的函数签名(含模板参数),不是原始模板名 - 若需拼接成完整日志字符串,推荐用
std::format(C++20)或fmt::format,避免std::string(__func__) + ":" + std::to_string(__LINE__)这类低效临时对象构造
Windows 下用 __FUNCTION__ 和 __FILE__ 补全路径信息
MSVC 默认启用 __FUNCTION__(等价于 __func__,但带完整命名空间和参数类型),而 __FILE__ 给出源文件绝对路径,容易过长。实际调试中更常用的是提取文件名而非全路径。
典型坑是直接打印 __FILE__ 导致日志刷屏,或未处理反斜杠转义(尤其在 JSON 日志中引发解析失败)。
立即学习“C++免费学习笔记(深入)”;
- 用
std::filesystem::path(__FILE__).filename().string()提取干净文件名(C++17) - MSVC 下
__FUNCTION__在类成员函数中会包含ClassName::method,而__func__只返回method,选哪个取决于是否需要上下文 - Clang/GCC 也支持
__FUNCTION__,但它是非标准扩展,跨平台项目建议优先用__func__ - 若需相对路径(如
src/util/log.cpp),需预处理构建系统注入-D__RELFILE__="src/util/log.cpp",再配合__RELFILE__使用
封装成日志宏时注意宏参数展开和逗号陷阱
写 #define LOG(fmt, ...) printf("[%s:%d] " fmt "\n", __func__, __LINE__, ##__VA_ARGS__) 看似简洁,但遇到 LOG("x=%d", f()) 时,f() 会在宏展开前求值——这没问题;真正危险的是 LOG("msg") 尾部逗号问题(##__VA_ARGS__ 在 GCC/Clang 中有效,MSVC 需 /Zc:preprocessor)。
更隐蔽的问题是宏内联后破坏断点调试体验:调试器看到的是展开后的代码,无法单步进原调用行。
- 推荐用内联函数替代宏,例如
inline void log(const char* func, int line, const char* fmt, ...),再用包装宏调用它,兼顾类型安全与调试友好 - 若坚持用宏,GCC/Clang 加
__attribute__((format(printf, 3, 4)))启用格式字符串检查;MSVC 用__declspec(format(printf, 3, 4)) - 避免在宏里调用可能抛异常的函数(如
std::string构造),否则异常栈帧会丢失原始__func__上下文 - C++20 的
source_location是更现代的替代方案,但它不能用于宏,且默认构造的current()返回调用点而非宏定义点
用 std::source_location 替代宏(C++20)
std::source_location 是标准库提供的类型安全方案,比宏更可控,但必须显式传参,不能自动捕获——这是它最易被忽略的限制。它不会“自动出现”,你得在每个需要的位置手动加 std::source_location loc = std::source_location::current()。
有人以为在日志函数参数里写个默认值就能一劳永逸,结果发现所有调用都显示日志函数自身的位置,而不是调用它的那行代码。
- 正确写法:
void log(std::string_view msg, const std::source_location& loc = std::source_location::current());,调用时无需传参,编译器自动填入调用点位置 -
std::source_location的file_name()返回 const char*,但内容由实现决定:GCC 返回相对路径,MSVC 返回绝对路径,Clang 行为类似 GCC - 它不包含函数签名,只有文件、行、列、函数名(
function_name()等价于__func__),无法替代__FUNCTION__的完整信息 - 性能上,它只是几个整数和指针的拷贝,比宏略重但可忽略;关键是它支持
constexpr,可在编译期参与计算(比如生成唯一日志 ID)
函数名和行号本身很简单,难的是在不同场景下选对机制:宏快但脆弱,source_location 安全但要记得传参,而 <strong>func</strong>/<strong>LINE</strong> 是那个永远在背后默默工作的基础。


















