指南 &
故障排除
常见问题的分步解决方案、安装帮助以及充分利用 Arduino IDE 的最佳实践。
问题与解决方案
安装或使用 Arduino IDE 时最常报告问题的快速修复。
IDE 无法检测开发板
- 确认 USB 数据线支持数据传输，而不仅是充电。
- 为您的操作系统安装正确的开发板驱动程序。
- 从工具菜单中选择正确的开发板型号和 PORT。
- 连接开发板后重新启动 IDE。
- 如果检测仍然失败，尝试更换 USB 端口或数据线。
上传时出现编译错误
- 检查是否选择了正确的开发板和处理器。
- 确保通过 Library Manager 安装了所有必需的库。
- 查看输出控制台中的错误消息以获取行号。
- 将开发板核心更新到最新版本。
- 使用自动格式化工具捕获语法问题。
Serial Monitor 显示乱码
- 将 Serial Monitor 中的波特率与您的草图设置匹配。
- 选择正确的行尾：无行尾、NL 或 CR+NL。
- 关闭可能正在使用同一 COM port 的其他程序。
- 确认开发板已通电且未处于复位模式。
库冲突和缺少依赖项
- 打开 Library Manager 并搜索缺少的库名称。
- 安装库作者推荐的精确版本。
- 从您的草图文件夹中删除重复的库。
- 安装或更新库后重新启动 IDE。
分步指南
在每个受支持的平台上安装 Arduino IDE 的详细步骤。
1. 从下载页面下载 Windows 安装程序 EXE。
2. 双击安装程序并按照安装向导进行操作。
3. 当提示时允许安装程序安装 USB 驱动程序。
4. 从开始菜单或桌面快捷方式启动 Arduino IDE。
5. 连接您的 Arduino 开发板，然后在工具下选择正确的 PORT。
6. 从文件 > 示例 > 01.基础 中打开 Blink 示例进行测试。
1. 从下载页面下载 macOS DMG 文件。
2. 打开 DMG 并将 Arduino IDE 拖入您的应用程序文件夹。
3. 如果 Gatekeeper 阻止应用，右键单击并选择打开。
4. 从应用程序中启动 Arduino IDE。
5. 如果提示，安装任何所需的开发板驱动程序。
6. 通过上传 Blink 示例验证安装。
1. 下载适合您架构的 AppImage 或 tar 包。
2. 对于 AppImage，使其可执行：chmod +x Arduino_IDE.AppImage
3. 直接运行 AppImage 或将 tar 包解压到您喜欢的位置。
4. 将您的用户添加到 dialout 组：sudo usermod -a -G dialout $USER
5. 注销并重新登录以使组更改生效。
6. 启动 Arduino IDE 并使用 Blink 示例进行验证。
更聪明地工作
来自社区和核心开发者的建议，助您获得流畅的 Arduino IDE 体验。
保持核心更新
定期通过 Board Manager 更新您的开发板核心。更新包括错误修复、性能改进和对新硬件变体的支持。
使用版本控制
将您的草图存储在 Git 仓库中。这可以保护您的工作，支持协作，并让您跟踪项目演进过程中的变更。
使用文件夹组织
使用草图文件夹结构来组织相关项目。为库、硬件定义和项目资源创建子文件夹。
增量测试
在组合之前先编写和测试小段代码。这比一次性调试一个庞大复杂的草图要容易得多。
阅读错误信息
Arduino IDE 提供详细的编译和上传消息。仔细阅读它们通常会揭示问题的确切行号和性质。
社区资源
Arduino 论坛和 Stack Exchange 社区是极好的资源。发帖前先搜索；大多数常见问题都有记录的解决方案。
了解杀毒软件警告
安装 Arduino IDE 时出现的杀毒软件警告几乎都是误报。这是因为 IDE 需要低级别访问 USB 串口和硬件驱动程序，某些启发式杀毒引擎会将其错误地归类为可疑行为。
Arduino IDE 经过数字签名，其源代码经过公开审计。从此站点分发的任何版本都不包含恶意软件、间谍软件或广告软件。如果您的杀毒软件阻止安装程序，您有几个安全选项：
- 验证安装程序文件的数字签名
- 将 SHA-256 校验和与发布的值进行比较
- 在您的杀毒软件设置中为 Arduino IDE 添加例外
- 如果您希望完全掌控，可以从源代码构建 IDE