C语言硬件相关配置管理方案咨询（独立于构建系统）

我正在开展一个基于C99代码库的嵌入式系统项目，需适配三款硬件模型，核心差异体现在存储传感器映射的常量数组中。现有两种配置方式均存在不足：

• 单文件预编译：所有配置堆叠在一起，Git追踪变更时易引发冲突，维护性差
• 拆分多文件：需创建7个文件，结构冗余，增加管理成本

希望找到不依赖构建系统、兼容Eclipse CDT与CMake的简洁方案，避免使用过多头文件或.c文件。以下是几种可行方案：

方案1：单头文件+宏封装配置组 #

将每个模型的配置用宏函数打包，通过预编译指令选择，既保持单文件结构，又清晰区分各模型配置，同时降低Git变更冲突概率。

// config.h
#ifndef CONFIG_H
#define CONFIG_H

// 模型A配置宏
#define CONFIG_MODEL_A() \
    #define PRODUCT_CODE 1 \
    #define NUMBER_OF_SENSORS 5 \
    const int temperature_sensor_map[NUMBER_OF_SENSORS] = {0, 1, 2, 3, 4};

// 模型B配置宏
#define CONFIG_MODEL_B() \
    #define PRODUCT_CODE 2 \
    #define NUMBER_OF_SENSORS 3 \
    const int temperature_sensor_map[NUMBER_OF_SENSORS] = {0, 2, 4};

// 模型C配置宏（示例）
#define CONFIG_MODEL_C() \
    #define PRODUCT_CODE 3 \
    #define NUMBER_OF_SENSORS 4 \
    const int temperature_sensor_map[NUMBER_OF_SENSORS] = {1, 3, 5, 7};

// 选择对应模型的配置
#if defined(MODEL_A)
    CONFIG_MODEL_A()
#elif defined(MODEL_B)
    CONFIG_MODEL_B()
#elif defined(MODEL_C)
    CONFIG_MODEL_C()
#else
    #error "必须定义MODEL_A、MODEL_B或MODEL_C"
#endif

#endif // CONFIG_H

方案说明 #

• 每个模型的配置独立封装，Git修改单个模型配置时仅影响对应宏块，减少冲突
• 无需额外.c文件，const变量默认静态链接，不会出现重复定义问题；满足自定义调试器仅能检查全局变量的需求
• 完全兼容预编译指令，Eclipse CDT和CMake均可通过编译选项（如-DMODEL_A）选择配置

方案2：X-Macro技术管理配置 #

利用X-Macro预处理器技巧批量生成配置代码，适合多相似配置场景，扩展性极强，新增模型只需在配置列表中添加一行。

// config.h
#ifndef CONFIG_H
#define CONFIG_H

// 配置列表：每个模型的参数（模型标识、产品码、传感器数量、传感器映射数组）
#define MODEL_CONFIG_LIST(X) \
    X(MODEL_A, 1, 5, {0, 1, 2, 3, 4}) \
    X(MODEL_B, 2, 3, {0, 2, 4}) \
    X(MODEL_C, 3, 4, {1, 3, 5, 7})

// 绑定选中的模型
#if defined(MODEL_A)
    #define SELECTED_MODEL MODEL_A
#elif defined(MODEL_B)
    #define SELECTED_MODEL MODEL_B
#elif defined(MODEL_C)
    #define SELECTED_MODEL MODEL_C
#else
    #error "必须定义MODEL_A、MODEL_B或MODEL_C"
#endif

// 提取选中模型的配置参数
#define EXTRACT_CONFIG(MODEL, CODE, COUNT, MAP) \
    #if SELECTED_MODEL == MODEL \
        #define PRODUCT_CODE CODE \
        #define NUMBER_OF_SENSORS COUNT \
        const int temperature_sensor_map[NUMBER_OF_SENSORS] = MAP; \
    #endif

MODEL_CONFIG_LIST(EXTRACT_CONFIG)
#undef EXTRACT_CONFIG

#endif // CONFIG_H

方案说明 #

• 所有模型配置集中在MODEL_CONFIG_LIST，新增模型只需添加一个X()项，维护成本极低
• Git变更时仅需修改对应行，冲突概率小
• 无需额外文件，兼容Eclipse和CMake的编译定义，后续新增参数（如电压传感器映射）只需修改X()参数和提取宏即可

方案3：单头文件+独立条件编译块（优化原始方案） #

保留条件编译逻辑，但将每个模型的配置块用注释和空行清晰分隔，提升可读性，避免嵌套#elif的潜在错误。

// config.h
#pragma once

// ====================== 模型A配置 ======================
#if defined(MODEL_A)
#define PRODUCT_CODE 1
#define NUMBER_OF_SENSORS 5
const int temperature_sensor_map[NUMBER_OF_SENSORS] = {0, 1, 2, 3, 4};
#endif

// ====================== 模型B配置 ======================
#if defined(MODEL_B)
#define PRODUCT_CODE 2
#define NUMBER_OF_SENSORS 3
const int temperature_sensor_map[NUMBER_OF_SENSORS] = {0, 2, 4};
#endif

// ====================== 模型C配置 ======================
#if defined(MODEL_C)
#define PRODUCT_CODE 3
#define NUMBER_OF_SENSORS 4
const int temperature_sensor_map[NUMBER_OF_SENSORS] = {1, 3, 5, 7};
#endif

// 强制校验模型定义
#if !defined(MODEL_A) && !defined(MODEL_B) && !defined(MODEL_C)
#error "必须定义MODEL_A、MODEL_B或MODEL_C"
#endif

方案说明 #

• 每个模型配置块独立，用注释分隔，可读性强
• 避免原始方案中#elif嵌套导致的配置错误（如重复定义宏）
• 单文件结构，兼容所有编译环境，Git修改目标明确

内容的提问来源于stack exchange，提问作者Akira Cleber Nakandakare