STM32头文件定义const结构体常量遇多重定义错误求助

问题原因 #

你在头文件中直接定义了const struct __PIN PA1，虽然加了const修饰，但C语言里全局const变量默认是外部链接属性。当这个头文件被多个.c文件（比如main.c和另一个业务.c）包含时，每个.c文件在编译阶段都会生成一份PA1的定义副本。链接器合并所有目标文件时，会发现多个同名符号的定义，因此抛出"multiple definition"错误。

解决方案 #

方案1：用static限定符（适合每个包含文件独立使用的场景）

修改头文件中的定义，添加static关键字：

typedef struct __PIN{
    GPIO_TypeDef GPIO;
    uint16_t pin;
}__PIN;

static const struct __PIN PA1 = {.GPIO=GPIOA,.pin=GPIO_PIN_5};

static会将变量的链接属性改为内部链接，每个包含头文件的.c文件都会拥有自己独立的PA1副本，链接时不会出现符号冲突。由于PA1是const常量，值不会被修改，多个副本完全等价，不影响使用。

方案2：extern声明+单独.c文件定义（推荐，全局共享同一实例）

这是C语言中全局常量的标准写法，确保整个项目只有一份定义：

1. 在头文件中仅做extern声明，不定义变量：

#ifndef __PIN_DEFS_H
#define __PIN_DEFS_H

typedef struct __PIN{
    GPIO_TypeDef GPIO;
    uint16_t pin;
}__PIN;

extern const struct __PIN PA1;

#endif /* __PIN_DEFS_H */

2. 创建一个对应的.c文件（比如pin_defs.c），在里面完成PA1的定义：

#include "你的头文件名.h"

const struct __PIN PA1 = {.GPIO=GPIOA,.pin=GPIO_PIN_5};

这样所有包含头文件的.c文件都会通过extern引用同一个PA1实例，链接时不会出现冲突。

补充：添加头文件保护

无论采用哪种方案，都应该给头文件加上保护宏，防止同一文件重复包含（这是头文件的规范写法，避免不必要的编译问题）：

#ifndef __PIN_DEFS_H
#define __PIN_DEFS_H

// 结构体定义、变量声明/定义都放在这里

#endif /* __PIN_DEFS_H */

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