VS2019中C++ Debug宏在Release模式下编译报标识符未找到

VS2019 默认编译配置中，_DEBUG 宏仅在 Debug 模式下自动预定义，Release 模式默认仅预定义 NDEBUG 宏，不会定义 _DEBUG。因此包裹在 #if _DEBUG 块中的 EngineLog 宏定义，在 Release 编译时会被预处理器完全跳过，不会被注册到宏表中。

对未定义宏处理逻辑的常见认知偏差：预处理器仅会直接丢弃判定为假的条件编译块内部的代码，不会自动移除块外对未定义宏的调用。当预处理器处理业务代码中的 EngineLog(xxx) 调用时，查宏表找不到对应条目，就不会对这段文本做宏替换，直接将其作为普通C++标识符传入后续语法分析阶段。语法分析阶段遍历当前作用域找不到名为EngineLog的函数、变量声明，就会抛出C3861标识符未找到错误。

最通用的零开销修复方式是补全Release模式下的空宏定义，保证两种编译模式下宏都存在。Release模式下所有日志调用会在预处理阶段被直接替换为空，不会生成任何运行时代码：

#if _DEBUG
#define EngineLog(vars, ...) Log(vars, ##__VA_ARGS__)
#else
// 标准空宏写法，无副作用，可避免悬空else等语法冲突
#define EngineLog(vars, ...) ((void)0)
#endif

额外注意事项：

• 不要在Release模式下直接暴露Log函数调用，否则会将调试日志逻辑打包到发布产物中，产生不必要的性能开销。
• 当前使用的##__VA_ARGS__是编译器扩展写法，VS2019可正常识别，如果后续需要兼容C++20标准实现跨编译器编译，可以替换为__VA_OPT__(,) __VA_ARGS__的标准写法。

如果业务要求Release模式下也保留日志输出，直接移除宏定义外层的#if _DEBUG条件判断即可。

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