Bootloader开发中FONT等结构体类型冲突报错原因与修复

• 头文件缺少包含保护，导致fb.h被重复引入两次：从编译日志可以看到，fb.h分别被main_uefi.c直接引用、被gop.h间接引用，同一头文件被两次展开后，里面的类型、函数、变量声明会被重复定义，触发类型冲突报错，这也是为什么报错里“前向声明位置”和“冲突声明位置”完全相同的原因。
• 采用匿名结构体做typedef定义：typedef struct { ... } 类型名的写法在重复包含时，编译器会将两次展开的匿名结构体判定为完全独立的不同类型，因此会出现“Framebuffer* 赋值给Framebuffer* 类型不兼容”这类看似矛盾的报错。
• 代码本身存在类型不匹配和无效语句问题：
  • 函数指针强转类型和定义的函数指针签名不一致，左边定义的是三参数入口，右边强转成了单参数函数指针
  • 函数指针第二个参数定义为FONT值类型，但实际传入的是FONT*指针
  • 单独写kernelBuffer->BaseAddress;这类仅读取成员、不做任何操作的语句属于无副作用的无效代码，开启-Werror=unused-value编译选项时会直接报错。

1. 给所有自定义头文件添加头文件保护，避免重复展开。以fb.h为例，在文件最开头添加保护宏，最末尾闭合：

   #ifndef FB_H
   #define FB_H
   
   // 此处放fb.h原有的所有结构体、函数、变量声明
   
   #endif
   

   其他自定义头文件比如gop.h也要按相同规则加对应保护。
2. 修改结构体定义，给匿名结构体加上对应标签，避免编译器将重复声明判定为不同类型，修改后的代码如下：

   typedef struct Framebuffer {
       void* BaseAddress;
       size_t BufferSize;
       unsigned int Width, Height;
       unsigned int PixelsPerScanLine;
   } Framebuffer;
   
   typedef struct FONT_HEADER {
       unsigned char magic[2];
       unsigned char mode;
       unsigned char charsize;
   } FONT_HEADER;
   
   typedef struct FONT {
       FONT_HEADER* fontHdr;
       void* glyphBuffer;
   } FONT;
   

3. 修复代码逻辑错误：
   • 对齐KernelEntry函数指针的定义和强转类型，同时修正参数类型匹配实际传参：

     // 第二个参数改为FONT*，和传入的kernelFont指针类型匹配，强转类型和左边定义完全一致
     __attribute__((sysv_abi)) int (*KernelEntry)(Framebuffer*, FONT*, BootInfo*) = 
         ((__attribute__((sysv_abi)) int (*)(Framebuffer*, FONT*, BootInfo*) ) kernel_elf_header->e_entry);
     

   • 删除main_uefi.c中161~165行单独读取结构体成员、无任何实际操作的无效语句。
   • 确认initGOP函数的返回值类型声明为Framebuffer*，完成前两步修复后，此处的类型不兼容报错会自动消除。

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