本篇主角长这样
适用于产品：NexArm智能机械臂
涉及模块：Arduino IDE / NexArm 库文件 / 主控板支持包
一、问题描述
用户在 Arduino IDE 中编译或上传程序时，控制台出现 Compilation error: PinButton.h: No such file or directory 报错，程序无法正常编译及上传。本文档将针对此报错，提供详细的排查步骤与操作指引。
报错信息如下：
Nex_Arm_Board.h:5:10: fatal error: PinButton.h: No such file or directory
compilation terminated.
exit status 1
Compilation error: PinButton.h: No such file or directory
二、问题说明
该报错说明 Arduino IDE 在编译代码时，无法在项目路径或库路径中找到 PinButton.h 这个头文件。这通常是因为用户没有导入 NexArm 运行所需的依赖库。NexArm 的后续程序中需要用到 PS3 Controller Host、MultiButton 和 U8g2 的依赖库，缺少这些库文件会导致编译失败。
三、解决方法
1. 库文件导入
请在 Arduino IDE 的库管理界面中分别输入这三个库的名称，并点击安装。
（1）在 Arduino IDE 界面左侧的侧边栏处点击“库管理器”图标（书本形状）。
（2）在弹出的库管理栏中输入“PS3 Controller Host”，IDE 就会自动搜索库文件，然后点击“安装”即可。
（3）库名称下方显示版本号，即表示安装成功。MultiButton 和 U8g2 库的安装方法同上，请依次搜索并安装。
2. 确认开发板型号与端口选择
确认 Arduino IDE「工具 → 开发板」中选择的是与实物匹配的 ESP32 开发板型号。型号选错会导致编译环境不匹配，同样可能触发相关报错。
同时确认「工具 → 端口」中选择的串口号与设备管理器中识别到的 ESP32 串口号一致。
3. 检查库文件是否安装完整
若已按照上述步骤安装，但仍报 PinButton.h 找不到的错误，请检查库管理器中是否确实已显示这三个库为“已安装”状态。如果安装后仍报错，建议重启 Arduino IDE 后再次尝试编译。
四、资源下载
若你的资料包丢失或找不到上述文件，可通过以下途径获取：
官方在线课程与资料库： 幻尔科技官网在线教程
客服领取： 联系你购买设备的店铺客服（淘宝/京东/天猫客服），提供订单号即可免费领取资料。