如何简化C++代码中大量重复的日志宏定义？

针对代码中每个模块重复定义DEBUG/WARNING/ERROR级日志宏的问题，以下是几种高效简化方案：

方案一：嵌套预处理器宏（推荐，完全兼容原有调用方式） #

通过定义一个模块日志宏生成器，一次性为指定模块生成三个级别的日志宏，彻底消除重复代码。

修改后的宏定义部分 #

// 保留原有的LOG_COMMON和LOG_SET_LEVEL不变

// 定义模块日志宏生成器：传入模块名前缀（如CAM）和标签前缀（如[CAM_）
#define DEFINE_MODULE_LOG_MACROS(MODULE_PREFIX, TAG_PREFIX) \
    #define MODULE_PREFIX##_LOG_ERROR(fmt, ...)   LOG_COMMON(ERROR,   TAG_PREFIX "E] " fmt, ##__VA_ARGS__) \
    #define MODULE_PREFIX##_LOG_WARNING(fmt, ...) LOG_COMMON(WARNING, TAG_PREFIX "W] " fmt, ##__VA_ARGS__) \
    #define MODULE_PREFIX##_LOG_DEBUG(fmt, ...)   LOG_COMMON(DEBUG,   TAG_PREFIX "D] " fmt, ##__VA_ARGS__)

// 为每个模块生成日志宏
DEFINE_MODULE_LOG_MACROS(CAM, "[CAM_")
DEFINE_MODULE_LOG_MACROS(PROC, "[PROC_")
DEFINE_MODULE_LOG_MACROS(SERVICE, "[SERVICE_")

原理说明 #

• 利用预处理器的##（Token拼接）和字符串自动拼接特性，将模块前缀与_LOG_ERROR等后缀拼接成最终宏名；
• 标签部分通过TAG_PREFIX + "E]"直接拼接成完整的模块级别标签，比如[CAM_ + "E]"就是[CAM_E]；
• 原有代码中的CAM_LOG_ERROR等调用完全不需要修改，直接兼容。

方案二：C模板类+辅助宏（更符合C风格） #

如果想减少宏的使用，可以用模板类封装模块标签，配合少量宏实现简化：

修改后的代码片段 #

// 保留原SimpleLog类和LOG_SET_LEVEL不变

// 模板类：每个模块特化该类以提供专属标签
template<typename ModuleTag>
struct ModuleLogTag {};

// 为CAM模块特化
struct CAMTag {};
template<> struct ModuleLogTag<CAMTag> { static constexpr const char* ErrorTag = "[CAM_E] "; static constexpr const char* WarnTag = "[CAM_W] "; static constexpr const char* DebugTag = "[CAM_D] "; };

// 为PROC模块特化
struct ProcTag {};
template<> struct ModuleLogTag<ProcTag> { static constexpr const char* ErrorTag = "[PROC_E] "; static constexpr const char* WarnTag = "[PROC_W] "; static constexpr const char* DebugTag = "[PROC_D] "; };

// 为SERVICE模块特化
struct ServiceTag {};
template<> struct ModuleLogTag<ServiceTag> { static constexpr const char* ErrorTag = "[SERVICE_E] "; static constexpr const char* WarnTag = "[SERVICE_W] "; static constexpr const char* DebugTag = "[SERVICE_D] "; };

// 辅助宏：调用时指定模块标签
#define MODULE_LOG(ModuleTag, Level, fmt, ...) \
do{ \
    constexpr const char* tag = ModuleLogTag<ModuleTag>::Level##Tag; \
    LOG_COMMON(Level, tag fmt, ##__VA_ARGS__); \
} while(false);

// 可选：为每个模块定义简化宏（如果想保留原有调用方式）
#define CAM_LOG_ERROR(fmt, ...)   MODULE_LOG(CAMTag, ERROR, fmt, ##__VA_ARGS__)
#define CAM_LOG_WARNING(fmt, ...) MODULE_LOG(CAMTag, WARNING, fmt, ##__VA_ARGS__)
#define CAM_LOG_DEBUG(fmt, ...)   MODULE_LOG(CAMTag, DEBUG, fmt, ##__VA_ARGS__)

// PROC和SERVICE同理，或者直接让业务代码使用MODULE_LOG(CAMTag, ERROR, ...)调用

优点 #

• 利用C++编译期特性，标签是静态常量，类型安全；
• 模块标签集中管理，便于后续扩展或修改。

方案三：统一日志宏+模块参数（最简宏定义） #

放弃每个模块单独定义宏，改用一个通用宏，调用时传入模块级别标签：

修改后的宏定义 #

// 保留原LOG_COMMON不变
#define LOG_MODULE(Level, ModuleTag, fmt, ...) LOG_COMMON(Level, ModuleTag " " fmt, ##__VA_ARGS__)

// 调用示例
LOG_MODULE(ERROR, "[CAM_E]", "the fd(%d) can't be opened!", 5);
LOG_MODULE(WARNING, "[PROC_W]", "failed to run function");

优缺点 #

• 优点：宏定义最少，无需为每个模块生成宏；
• 缺点：调用时需要手动传入模块标签，不如原有方式直观，容易写错标签格式。

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