Platform.io环境下Arduino项目出现MainController未定义引用编译错误求助

编译时出现的undefined reference to MainController::MainController()和undefined reference to MainController::begin()是典型的链接错误，根源在于MainController.cpp的写法错误：你在cpp文件里重新定义了一个全新的MainController类，而非实现头文件中声明的类，导致编译器无法关联到头文件的类声明与实现代码。

修复步骤 #

1. 修正MainController.cpp的实现方式
   将原cpp文件中的类定义改为成员函数的实现，并且必须包含对应的头文件，正确代码如下：

   #include "MainController.h"
   
   MainController::MainController() {
   }
   
   void MainController::begin() {
     motorController.begin();
   }
   
   void MainController::update() {
   }
   

   说明：cpp文件需要通过#include "MainController.h"关联到头文件的类声明，然后使用类名::成员函数的语法实现成员，而非重新定义整个类。

2. 验证项目文件结构
   确保MainController.h和MainController.cpp都放在PlatformIO项目的src目录下，编译系统默认只会编译该目录下的源码文件。

额外检查点 #

• 确认MotorController类的头文件与cpp文件也遵循同样的实现规则，避免引发类似的未定义引用错误。
• 检查platformio.ini配置，确保没有通过src_filter等配置排除MainController.cpp的编译。

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