fatal error: xxx.h: No such file or directory：缺少库或开发板选错（找不到头文件）
所有开发板 常见问题 · 排查从第 L3 层开始
日志里常见的字样
fatal error: xxx.h: No such file or directory这条报错说明什么
编译器找不到
先做这一步
看报错里的文件名。板伴会在下方列出每个缺失头文件对应的库和安装方法；如果是开发板自带的（如 WiFi.h、Wire.h），先检查开发板是否选对。
按头文件名查：320 个常用库的安装方法，以及开发板自带头文件找不到时怎么查
按顺序排查，别跳步
- L0供电：核对供电与指示灯
- L1连接：确认 USB、驱动与端口
- L2烧录：检查模式、工具与配置
- L3最小程序：建立独立运行基线
断开外设，运行与板型匹配的 LED 或串口最小程序。 - L4串口：确认运行日志
- L5外设：逐个验证接线和通信
ESP32-C3 SuperMini 的注意事项
- GPIO 不耐受 5V。
- 板载蓝色 LED 在 GPIO8，低电平点亮；BOOT 键接 GPIO9。GPIO2、8、9 影响启动，外设不要在上电时把它们拉低。
- 没有 USB 转串口芯片，串口走芯片自带的 USB：Arduino IDE 必须把「USB CDC On Boot」设为 Enabled，否则 Serial 什么都打印不出来。
- 程序复位或进入下载模式时，电脑上的 COM 口会消失再出现，有时编号会变，需要重新选择端口。
- 一些库默认 I²C 用 GPIO8/9，但它们是 LED 和 BOOT 键；这里的 I²C 模板改用 GPIO4（SDA）/ GPIO5（SCL）。
- GPIO0–4 是 ADC1，GPIO5 是 ADC2（Wi-Fi 打开时 ADC2 不能用）。
- 「SuperMini Plus」版本的 GPIO8 是 WS2812 彩灯，不是普通 LED。
相关问题
板伴 Boardly · 给硬件初学者的免费排错工具。内容依据公开资料整理，尚未逐条经过实物验证，请以实际测量为准。