Arduino项目外部C++文件编译报错，求助解决方法

问题描述 #

项目文件结构如下：

arduino.ino <- 主程序文件
/HeartSensor
    HeartSensor.h
    HeartSensor.cpp
/oledScreen
    oledScreen.h
    oledScreen.cpp

主文件中通过以下代码引入子文件夹内的头文件：

#include "HeartSensor/HeartSensor.h"
#include "oledScreen/oledScreen.h"

以HeartSensor类为例，头文件中声明了addSample方法，在对应的HeartSensor.cpp中实现该方法。调用头文件内的内联成员函数（如getter/setter）时正常，但调用addSample时触发链接错误：

arduino.ino:36: undefined reference to `HeartSensor::addSample(float const&)' 
collect2: error: ld returned 1 exit status

核心原因 #

Arduino IDE默认只会编译主目录下的源文件（.cpp/.ino），不会自动递归扫描子文件夹中的cpp文件，导致链接阶段找不到函数的实现代码。

解决步骤 #

方法一：手动将子文件夹的cpp文件加入项目 #

• 打开Arduino IDE，点击顶部菜单栏的「项目」→「添加文件」
• 依次选择HeartSensor/HeartSensor.cpp和oledScreen/oledScreen.cpp，添加到当前项目
• 保存项目后重新编译即可

方法二：调整文件结构（简化操作） #

将所有.h和.cpp文件移动到主目录下（与arduino.ino同级），然后修改主文件中的引入语句为：

#include "HeartSensor.h"
#include "oledScreen.h"

此时IDE会自动编译所有同目录下的cpp文件，无需额外操作。

额外注意：修复空指针问题 #

你的调用代码存在潜在崩溃风险：

HeartSensor* myHeartSensor;
myHeartSensor->addSample(0.0);

myHeartSensor是未初始化的野指针，直接调用成员函数会导致运行时错误，需要先实例化对象：

// 栈上实例化（推荐，无需手动释放）
HeartSensor myHeartSensor;
myHeartSensor.addSample(0.0);

// 堆上实例化（需手动释放内存）
HeartSensor* myHeartSensor = new HeartSensor();
myHeartSensor->addSample(0.0);
// 使用完毕后释放内存
delete myHeartSensor;

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