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

Adafruit_GFX.h: No such file or directory

编译时找不到 Adafruit_GFX.h，说明还没有安装提供它的库：Adafruit GFX Library（作者 adafruit）。

完整报错通常长这样

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

Arduino IDE 里安装

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

PlatformIO 里安装

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

lib_deps = adafruit/Adafruit GFX Library@^1.13.0

命令行（Arduino CLI）

arduino-cli lib install "Adafruit GFX Library"

关于这个库

Adafruit GFX graphics core library, this is the 'core' class that all our other graphics libraries derive from. Install this library in addition to the display

最新版本：1.13.0 · 支持：所有平台 · 被 205 个库依赖

源码：github.com/adafruit/Adafruit-GFX-Library · PlatformIO 页面

装了还是报错？

装错了同名库：库管理器里常有好几个名字相近的库，确认作者是 adafruit。同样提供 Adafruit_GFX.h 的还有：arduino-libraries/TFT、dfrobot/DFRobot_RGBMatrix，示例代码用的是哪一个，就装哪一个。
开发板不支持：这个库支持所有平台。换成不支持的板子时，即使装上也可能编译出错。
缺依赖库：报错里出现新的「No such file」时，再按同样的方法装那个头文件对应的库。板伴可以一次识别所有缺失的头文件。
大小写不对：Linux 和 macOS 区分大小写，#include 里的文件名要和 Adafruit_GFX.h 完全一致。

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

adafruit 的其他常用库

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