如何用可在头文件中一次性定义的现代C++替代现有错误上报宏

完全可以实现和原预编译宏功能完全一致的逻辑，且满足头文件单次通用定义、无需多处重复声明的要求，具体实现如下：

核心实现逻辑 #

依靠现代C++的源位置自动捕获能力，配合inline函数完成封装，彻底替代预编译宏的文本替换逻辑：

// 以下代码直接写入公共头文件即可，多模块重复包含也不会触发链接层面的重定义错误
#include <string>
#include <source_location>

// 项目已定义的错误处理函数，无需重复声明
void ErrorMsg(const std::string &file, int line, const std::string &report);

// 与原Error宏功能完全等价的封装函数
inline void Error(std::string error_msg,
                  std::source_location call_loc = std::source_location::current()) {
    ErrorMsg(call_loc.file_name(), call_loc.line(), std::move(error_msg));
}

功能一致性验证 #

• 调用形式和原宏完全无差异：现有代码中所有Error("错误描述")的写法不需要任何修改。编译器会自动在每一处调用点，将当前代码所属的文件路径、行号填充到默认参数call_loc中，最终传入ErrorMsg的参数值和原宏展开的结果完全一致。
• 符合头文件定义要求：函数标注inline后，同一头文件被多个编译单元包含时，链接器会自动合并相同的函数定义，不会出现重复声明、重复定义的报错，实现一次定义全局可用。

旧版本兼容方案 #

• C20以下的项目可直接替换为编译器内置的位置获取能力：GCC、Clang、MSVC目前均支持__builtin_FILE()、__builtin_LINE()内置函数，在默认参数位置传入这些内置函数，整体封装逻辑不变，不需要依赖C20的标准库实现。

相对原预编译宏的额外优势 #

• 无宏的固有缺陷：不会出现宏展开带来的无类型检查、编译报错位置偏移、全局命名污染、参数二次求值等问题。
• 适配性更强：当传入的错误消息参数包含逗号、嵌套表达式时，预编译宏会因为自身的参数分隔规则出现展开错误，inline函数完全不受这类语法限制。
• 性能更优：通过std::move传递错误消息字符串，减少不必要的内存拷贝开销。
• 符合正常C++语法规则：支持命名空间隔离、函数重载、被函数指针正常引用。

内容的提问来源于stack exchange，提问作者ATK