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

BluetoothSerial.h: No such file or directory

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

自带这个头文件的开发板

ESP32 系列

原因和解决方法

经典蓝牙串口，只有经典 ESP32（ESP32-WROOM / WROVER）支持。ESP32-S3、C3、C6 只有低功耗蓝牙（BLE），要改用 BLE 方案，例如 NimBLE-Arduino。

先检查这两处

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

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