树莓派4自研非Linux系统构建报fb_info多重定义链接错误求解

• 这是C语言项目中典型的头文件内直接定义全局变量导致的链接阶段符号冲突，GCC 10及以上版本已移除对这类问题的宽松兼容，会直接抛出multiple definition报错。
• 你在framebuffer.h第22行直接书写的framebuffer_info_t fb_info;，属于全局变量的实体定义，而非声明。
• C语言编译流程中，每个包含该头文件的.c源文件，在单独编译生成独立.o目标文件时，都会在自身符号表内生成一份fb_info的实体。
• 链接器将所有.o文件拼接为最终内核镜像时，会检测到多个目标文件中存在同名的fb_info实体，因此抛出冲突报错。报错中提到的mailbox.o、framebuffer.o，就是因为两个文件都引入了framebuffer.h，各自生成了一份重复的fb_info符号。

• 修改framebuffer.h中的fb_info定义，将其从实体定义改为外部声明，在类型前添加extern修饰：
  原代码：framebuffer_info_t fb_info;
  修改为：extern framebuffer_info_t fb_info;
  头文件仅承担对外暴露接口的作用，只允许书写全局变量的声明，绝对不能写实体定义。
• 在唯一对应的实现文件framebuffer.c中，添加fb_info的实体定义，无需加extern修饰，直接书写framebuffer_info_t fb_info;即可。这样全项目只会生成一份fb_info实体，其余引用了framebuffer.h的源文件（如gpu.c、mailbox.c）都可以正常访问这份唯一实体，不会产生重复定义。

所有同类multiple definition报错都可以按照以下规则定位解决：

• 头文件中不带extern的全局变量定义、不带static修饰的普通函数实体，会在每一个引入该头文件的.o文件中生成重复符号，触发链接错误
• 头文件中仅允许放置：类型定义、宏定义、函数原型声明、带extern修饰的全局变量声明、带static/inline修饰的函数实现
• 全局变量实体、普通函数实现，必须放到单一对应的.c实现文件中，保证全项目仅保留一份实体符号

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