308.3、开发软件的安装

一、安装环境的配置

本节在 Windows 10 上安装课程工具包中的 Arduino IDE 2.0.1（64 位），随后设置简体中文界面并选择 Arduino Uno 板型。视频没有编写太阳能追光路灯的业务代码；编辑区出现的 setup()、loop() 只是 IDE 自动创建的空白草图，因此本节不收录源码。

版本边界需要先说明：课程画面和配套安装包都是 2.0.1，而精校时 Arduino 官方下载页提供的是更新版本。若要逐项复现视频界面，可以使用课程包中的 2.0.1；若是新电脑长期使用，通常应优先从 Arduino 官方页面获取当前稳定版。新版的菜单文字和位置可能略有变化，但“安装 IDE、选择板型、选择端口、编译与上传”的基本流程不变。

1.1 打开软件安装包

1.1.1 确认安装文件

视频从课程目录进入 软件安装包 文件夹，运行：

arduino-ide_2.0.1_Windows_64bit.exe

本地配套文件核验结果如下：

项目	核验结果
文件版本	2.0.1
产品版本	2.0.1
发布者	Arduino SA
Windows 数字签名	有效
SHA-256	C445AEBE9F6A039D24A83BC5C12C922E28735EEDE7402B9CF9F69F9DFDE630FE

如果使用从网络重新下载的安装程序，其版本、文件大小和哈希可能不同，不应强求与课程文件具有相同 SHA-256；但应从 Arduino 官方下载页获取，并在 Windows 的“属性 → 数字签名”中核对发布者，避免运行来源不明的安装包。

1.1.2 按视频完成安装

视频中的安装顺序是：

1. 双击 64 位安装程序；若 Windows 弹出用户账户控制提示，核对发布者后再允许运行。
2. 阅读许可协议，点击“我同意”继续。
3. 使用安装程序的默认设置，等待绿色进度条完成。
4. 安装结束后启动 Arduino IDE；视频中桌面也生成了 Arduino IDE 快捷方式。

讲师说“默认安装在 C 盘就好”，视频实际没有展示手动修改安装目录，而是直接使用默认路径。这不是说 IDE 必须安装到 C 盘。Arduino 官方资料给出的 Windows 默认位置会随安装范围而不同：

• 为所有用户安装：通常位于 C:\Program Files\Arduino IDE；
• 仅为当前用户安装：通常位于 C:\Users\用户名\AppData\Local\Programs\Arduino IDE。

安装位置存放的是 IDE 程序本体；草图、库和开发板平台还有各自的数据目录。以后备份工程时，不能只复制 IDE 安装文件夹。

1.1.3 首次启动时看到什么

视频约 00:55 打开 Arduino IDE 2.0.1，窗口中央自动出现一个空白草图，其中有 setup() 和 loop() 两个框架函数。此时状态栏仍显示没有选择开发板。

首次启动可能需要初始化配置、读取开发板索引或检查更新，因此速度可能比以后慢。若界面暂时没有响应，应先等待初始化完成，不要连续重复启动多个 IDE 进程。

1.2 中文界面的设置

1.2.1 视频中的设置路径

如果首次打开是英文界面，在 Windows/Linux 上按以下路径操作：

File → Preferences → Editor Language → 中文（简体） → OK

对应的中文菜单是：

文件 → 首选项 → 编辑器语言 → 中文（简体） → 确定

也可以使用快捷键 Ctrl + , 打开首选项。视频中的语言选项旁标有“需要重新加载”；Arduino 官方帮助文档也要求重启 IDE 才能让语言变更完整生效。因此点击“确定”后，如果仍有菜单没有变化，应完全退出 IDE 再重新打开。

不要依赖“倒数第三个菜单项”来找首选项。不同 IDE 版本或操作系统可能增加、删除菜单，按 Preferences/“首选项”的名称查找更可靠。切换界面语言只改变 IDE 自身菜单；编译器、上传工具或第三方工具输出的部分英文信息不会因此被翻译。

1.2.2 语言设置不会改变程序行为

界面语言只影响按钮、菜单和提示文字，不会改变：

• Arduino 语法和函数名称；
• 程序的编译结果；
• 开发板平台和库的版本；
• USB 串口号；
• 上传到开发板中的程序。

因此，中文界面便于初学者熟悉操作，但遇到英文报错时仍应保留原文搜索，不能把报错逐字翻译后再查。

1.3 开发板的选择

1.3.1 按视频选择 Arduino Uno

视频约 01:13～01:27 使用以下菜单：

工具 → 开发板 → Arduino AVR Boards → Arduino Uno

Arduino AVR Boards 是开发板平台包，里面包含 Uno、经典 Nano、Mega 等 AVR 开发板的编译和上传配置；Arduino Uno 才是本项目要选择的具体板型。视频中这个平台包已经安装，所以菜单里能够直接看到 Uno。

若菜单中没有 Arduino AVR Boards，可打开“开发板管理器”，搜索并安装由 Arduino 发布的 Arduino AVR Boards，完成后再选择 Arduino Uno。不要因为名称里都含有“Uno”就误选 Uno WiFi Rev2、Uno R4 或其他型号，它们的主控架构和编译配置不同。

1.3.2 “开发板”和“端口”是两项设置

视频只选择了开发板，没有展示端口选择。两者作用不同：

设置	告诉 IDE 什么信息	是否必须连接实物
开发板 Arduino Uno	使用什么编译参数、主控定义和上传协议	不连接板子也可以先选择并编译
端口 COMx	程序要上传到电脑上的哪一个实际串口设备	上传前必须连接并识别开发板

仅选择 Arduino Uno 并不代表电脑已经连上实物。上传程序前还应：

1. 用具有数据传输功能的 USB Type-B 线连接课程 Uno 兼容板和电脑。
2. 打开 工具 → 端口，选择插板后新出现的 COMx。
3. 也可以点击 IDE 2 顶部的开发板选择器，在同一对话框中选择板型和端口。
4. 拔下开发板后观察哪个端口消失，再插回观察哪个端口出现，这是识别目标端口的可靠方法。

COM3、COM5 等编号由当前电脑分配，没有固定值，不能照抄别人的端口号。官方文档还说明，IDE 2 在没有检测到任何串口时，工具 → 端口 这一项可能完全不显示。

1.3.3 CH340G 兼容板的驱动

第 307 节已经确认，课程板使用 CH340G USB 转串口芯片。Windows 有时会自动安装驱动；如果连接后没有出现新端口，应按以下顺序排查：

1. 换用确定能够传输数据的 USB 线，避免把充电线当成数据线。
2. 换一个 USB 接口，并查看 Windows“设备管理器”是否出现未知设备或带感叹号的串口设备。
3. 必要时从 WCH（沁恒）官方网站安装 CH340/CH341 驱动，不从随机网盘或不明驱动站下载。
4. 驱动安装后重新插拔开发板，再选择新出现的端口。

驱动只解决电脑识别 CH340G 的问题，不会自动替你选择 Arduino Uno 板型，也不会修复接线或程序错误。

二、安装完成后的验收

本节视频在选中 Arduino Uno 后结束，没有进行上传。为了确认环境真正可用，可以按以下清单验收：

1. IDE 能正常打开，菜单和编辑区显示完整。
2. Arduino AVR Boards 已安装，能够选择 Arduino Uno。
3. 插入开发板后能看到对应的 COM 端口。
4. 选择正确板型和端口后，打开 IDE 自带的 Blink 示例，先点击“验证”确认能够编译。
5. 再点击“上传”，观察无上传错误且板载 L 指示灯按示例规律变化。

“验证”只编译程序，不要求端口；“上传”需要正确端口和可通信的开发板。若编译成功但上传失败，应优先检查板型、端口、USB 线和驱动，而不是随意修改程序。

三、课程版本与当前版本的差异

• 课程使用 Arduino IDE 2.0.1，视频中的菜单和按钮以该版本为准。
• 精校时 Arduino 官方下载页显示的稳定版已经更新，之后还会继续变化；下载时以官方页面显示为准。
• 新版 IDE 2 更强调顶部开发板选择器，仍可通过 工具 → 开发板 和 工具 → 端口 分别选择。
• 旧版课程包有利于复现画面，但不应从非官方来源长期传播；新安装优先使用官方稳定版，只有出现明确的课程兼容问题时再回退。
• 无论 IDE 版本如何，太阳能追光路灯使用的目标板型仍是经典 Arduino Uno，其平台归属为 Arduino AVR Boards。

核对依据

• 本地 videos/308.3、开发软件的安装.mp4 与对应转录：逐段核对 2.0.1 安装、首次启动、简体中文设置和 工具 → 开发板 → Arduino AVR Boards → Arduino Uno；视频时长约 1 分 30 秒。
• 配套 arduino-ide_2.0.1_Windows_64bit.exe：核对文件版本、发布者、有效数字签名和 SHA-256；没有执行安装程序，只对现有文件做只读校验。
• Arduino 官方软件下载页：获取当前稳定版并核对官方发布渠道；版本号会随时间更新。
• Arduino：Download and install Arduino IDE：核对 Windows 安装流程。
• Arduino：Change the language in Arduino IDE：核对语言菜单、快捷键和重启要求。
• Arduino：Select board and port in Arduino IDE：核对板型与端口的区别，以及 IDE 2 的两种选择方法。
• Arduino：Add boards to Arduino IDE：核对开发板平台包和开发板管理器的用途。
• WCH CH340/CH341 官方驱动页面：课程 CH340G 兼容板在 Windows 无法识别时的驱动来源。