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

FastLED.h: No such file or directory

编译时找不到 FastLED.h，说明还没有安装提供它的库：FastLED（作者 fastled）。

完整报错通常长这样

fatal error: FastLED.h: No such file or directorycompilation terminated.

Arduino IDE 里安装

菜单「工具 → 管理库」，或按 Ctrl+Shift+I。
搜索框输入 FastLED。
在结果里找作者为 fastled 的那一个，点「安装」。如果弹窗问是否一起安装依赖库，选「全部安装」。
重新编译。

PlatformIO 里安装

在 platformio.ini 对应的环境下加一行，保存后重新编译，会自动下载：

lib_deps = fastled/FastLED@^3.10.9

命令行（Arduino CLI）

arduino-cli lib install "FastLED"

关于这个库

FastLED is a library for programming addressable rgb led strips (APA102/Dotstar, WS2812/Neopixel, LPD8806, and a dozen others) acting both as a driver and as a

最新版本：3.10.9 · 支持：Arduino Uno/Nano（AVR）、Arduino Nano Every、Arduino Due/Zero、freescalekinetis、nordicnrf51、nRF52、nxplpc、STM32、renesas-ra、Teensy、ESP8266、ESP32 · 许可证：MIT · 被 45 个库依赖

源码：github.com/FastLED/FastLED · PlatformIO 页面

装了还是报错？

装错了同名库：库管理器里常有好几个名字相近的库，确认作者是 fastled。同样提供 FastLED.h 的还有：etidbury/FastLED、franzisco29/RaceDisplay，示例代码用的是哪一个，就装哪一个。
开发板不支持：这个库支持 Arduino Uno/Nano（AVR）、Arduino Nano Every、Arduino Due/Zero、freescalekinetis、nordicnrf51、nRF52、nxplpc、STM32、renesas-ra、Teensy、ESP8266、ESP32。换成不支持的板子时，即使装上也可能编译出错。
缺依赖库：报错里出现新的「No such file」时，再按同样的方法装那个头文件对应的库。板伴可以一次识别所有缺失的头文件。
大小写不对：Linux 和 macOS 区分大小写，#include 里的文件名要和 FastLED.h 完全一致。

把完整编译报错贴进板伴，自动找出缺哪些库一次识别报错里的所有缺失头文件，按你的开发板给出能用的库和安装方法。免费、不用注册，日志只在你的浏览器里分析。

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