极简SPI类代码编译失败求助：C++项目出现编译错误

问题代码与错误信息 #

编写的SPI类头文件代码：

#ifndef SRC_SPI_H_
#define SRC_SPI_H_

class SPI {

};

#endif

编译触发以下错误：

• expected '=', ',', ';', 'asm' or '__attribute__' before '{' token SPI.h /ICM_Tester/Core/Src line 4
• unknown type name 'class' SPI.h /ICM_Tester/Core/Src line 4

核心原因 #

这两个错误的本质是编译器正在用C语言规则处理该头文件，而非C++。即使项目整体标记为C++，也可能存在局部配置或引用问题：

• 包含该头文件的源文件是.c后缀，编译器默认以C模式编译该源文件，连带处理头文件时禁用C++语法。
• 单个文件的编译配置被修改，强制将SPI.h或其关联源文件设为C语言编译。
• 该头文件被某个C语言源文件间接包含，触发C规则校验。

解决步骤 #

1. 修正源文件后缀：确保所有引用SPI.h的源文件后缀为.cpp（或.cxx/.cc等C标准后缀）。如果必须在C文件中引用，给头文件添加C兼容声明：

   #ifndef SRC_SPI_H_
   #define SRC_SPI_H_
   
   #ifdef __cplusplus
   class SPI {
   
   };
   #else
   // C环境下的兼容声明，避免编译报错
   typedef void SPI;
   #endif
   
   #endif
   

2. 检查编译配置：在IDE中找到SPI.h或其对应的实现文件，查看文件属性，确认编译语言设置为C++而非C。
3. 排查包含关系：检查项目中是否有.c文件直接/间接包含SPI.h，如有则要么将该.c文件改为.cpp，要么使用上述条件编译兼容C环境。

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