板伴 / 缺少头文件 / SoftwareSerial.h

SoftwareSerial.h: No such file or directory

SoftwareSerial.h 不需要从网上另外下载：它随开发板的支持包（核心）一起安装。找不到它，几乎都是因为开发板选错了，或者这块板子本来就没有这个功能。

自带这个头文件的开发板

Uno / Nano（AVR）、ESP8266、树莓派 Pico、STM32

原因和解决方法

软件串口库。Uno / Nano / ESP8266 自带；ESP32 核心没有它。ESP32 有 3 个硬件串口，优先用 Serial1、Serial2（可以指定任意引脚）；确实需要软件串口时再装 EspSoftwareSerial。

先检查这两处

  1. Arduino IDE：菜单「工具 → 开发板」，选的是不是你手上那块板子？ESP32 要先在「开发板管理器」里安装 esp32 支持包。
  2. PlatformIO：platformio.ini 里的 board 和 platform 是否和实物一致，framework = arduino 有没有写。
把完整编译报错贴进板伴，自动找出缺哪些库一次识别报错里的所有缺失头文件，按你的开发板给出能用的库和安装方法。免费、不用注册，日志只在你的浏览器里分析。

板伴 Boardly · 给硬件初学者的免费排错工具。内容依据公开资料整理，尚未逐条经过实物验证，请以实际测量为准。