使用PIC32与OPT3101时出现multiple definition编译错误求助

问题根源 #

你遇到的链接错误核心原因是全局变量在头文件中直接定义并初始化，而该头文件被多个C源文件包含。头文件保护（#ifndef...#define...#endif）仅能防止单个源文件重复包含同一头文件，无法阻止不同源文件各自生成一份变量定义，最终链接阶段就会触发"multiple definition"冲突。

具体到你的代码：registerToEeprom在i2cOptConfig.h中直接定义初始化，该头文件被i2cOpt.h包含，i2cOpt.h又同时被opt3101.c和i2cOpt.c包含，导致两个源文件编译后都带有该变量的定义，链接器因此报错。

修复步骤 #

1. 修改头文件，仅声明变量 #

编辑i2cOptConfig.h，将变量的定义改为extern声明，保留结构体类型和宏定义：

#ifndef I2C_OPT_CONFIG_H
#define I2C_OPT_CONFIG_H

// macros, including NB_OF_INIT_REGISTERS

typedef struct 
{
    uint8_t registerAddress;
    uint8_t eepromAddress;
} address_s;

// 仅声明变量，不做初始化
extern const address_s registerToEeprom[NB_OF_INIT_REGISTERS];

#endif /* I2C_OPT_CONFIG_H */

2. 在单个C源文件中定义并初始化变量 #

选择唯一的C文件（比如i2cOpt.c），添加变量的实际定义和初始化：

#include <xc.h>
#include "system.h"
#include "i2cOpt.h"
#include "i2c1.h"
#include "i2c2.h"

#ifndef OPT_REFERENCE_3101
#define OPT_REFERENCE_3101
#endif

// 在这里定义并初始化变量，全局仅保留这一份实例
const address_s registerToEeprom[NB_OF_INIT_REGISTERS] = 
{
    {0x0B, 0x65},
    {0x0F, 0x0E},
    {0x10, 0x00},
    {0x13, 0x00},
    {0x14, 0x00} 
};

3. 重新编译验证 #

重新编译项目，链接器的重复定义错误会消失。所有需要使用registerToEeprom的源文件（比如opt3101.c）会通过包含链拿到extern声明，从而正确引用i2cOpt.c中定义的唯一变量实例。

额外注意事项 #

• 禁止在头文件中定义全局变量（除非用static限定，但static会让每个源文件生成独立实例，不符合跨文件共享变量的需求）。
• extern声明仅告知编译器"该变量在其他地方已定义"，只有单个C文件中的定义才会实际分配内存。

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