Arduino IDE中.c文件使用HardwareSerial报未知类型错误的解决请求

错误原因 #

HardwareSerial是Arduino核心库提供的C++类，而.c文件会被编译器以C语言规则编译。C语言不支持类、对象实例化等C++特性，因此直接在C文件中使用HardwareSerial会触发类型未定义的错误。

解决方案 #

方案1：将.c文件改为.cpp文件 #

这是最直接且推荐的方法，因为Arduino生态本身基于C++构建：

1. 把代码文件名从xxx.c改成xxx.cpp
2. 保留原代码即可：

#include "Arduino.h"

HardwareSerial obj(0);

编译器会以C++规则编译该文件，Arduino.h会正确引入HardwareSerial类的定义，错误即可消除。

方案2：在C文件中使用C风格串口操作函数 #

如果必须使用C文件，可改用Arduino提供的底层C语言串口接口（无需依赖C++类），示例代码：

#include "Arduino.h"

void setup() {
    // 初始化串口0（对应原生Serial），波特率9600
    serial_begin(0, 9600);
}

void loop() {
    // 发送单个字符
    serial_write(0, 'H');
    // 发送字符串并换行
    serial_println(0, "Hello from C");
    delay(1000);
}

注意：部分Arduino平台的底层C串口函数命名可能略有差异，比如ARM架构平台可能使用uart_init等函数，可参考对应平台的核心库文档。

额外说明 #

不要尝试在C文件中直接引入HardwareSerial.h——该头文件是C++语法编写的，包含类定义、成员函数等C语言无法解析的内容，会导致更多编译错误。

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