1. 安装前先想清楚选 1.x 还是 2.x这套环境装来干什么Arduino IDE 这些年变化挺大很多老玩家还在用 1.8.x而官方已经默认推荐 2.x 版本。动手下载之前建议先把这个问题想明白否则装完再换版本开发板管理器缓存、第三方 JSON 地址、库文件路径都要重新折腾一遍浪费时间还没什么收获。Arduino IDE 2.x 是基于 Electron 框架重写的和过去那个需要 Java 运行时、界面停留在十年前的老版本完全是两个东西。2.x 自带代码自动补全、内置串口监视器、直接的库管理面板还能在同一个窗口里管理多个开发板平台。体验上比 1.x 顺畅很多尤其是写大一点的工程时搜索变量定义、跳转函数声明这些操作终于不用靠插件了。不过代价就是内存占用偏高一台 4GB 内存的老笔记本同时开浏览器和 IDE明显能感觉到卡顿。如果你只是偶尔烧录一次简单的 Blink 例程用 1.8.19 反而干脆利落。现在的核心问题是你装的这套环境接下来要做什么如果只是入门学 Arduino 基础语法、点亮一颗 LED、读个传感器那 2.x 没有任何问题官方推荐的安装包直接选它。如果你要搞 ESP32、ESP8266、STM32 这类第三方的开发板2.x 也完全支持只是首次添加开发板管理器地址和下载工具链时的流程稍有不同。如果是为了在 PX4、ROS、树莓派联动这类更复杂的嵌入式场景里做一个辅助上位机那装有线更稳定、Arduino-CLI 能配合脚本调用但 IDE 图形界面还是 2.x 顺手。从我这边的实际体验来看新项目的起步统一用 2.x 就好。老项目的维护只要现有环境不出问题没必要为了“追新”去迁移。下面三个平台的安装步骤我都以 Arduino IDE 2.x 为主来写如果后面需要 1.x 的配置差异说明单独看相应小节就好。2. Windows 平台官方安装包之外的驱动与权限问题Windows 是 Arduino 用户最多的平台安装本身不太容易卡住真正的坑基本都集中在串口驱动和系统权限上。这一部分我按“下载、安装、验证、排错”的顺序展开。2.1 下载与安装注意区分系统架构官网下载页面会自动检测你的系统版本Windows 下有个小地方要留神新版安装包会区分 x86、x64 和 ARM64。绝大多数 Windows 电脑是 x64 架构直接选 Windows Win 10 and newer 下面的 64-bit 版本就行。如果你用的是 Surface Pro X 这类 ARM 芯片的机器别下错 x64 包安装能完成但驱动签名容易出问题记得选 ARM64 版本。下载完成后双击安装包一路默认即可。安装过程中有一个步骤会让你选择“仅为我安装”还是“为所有用户安装”这个看使用场景。如果这台电脑还要给别人用建议选“为所有用户安装”省得之后切换 Windows 账户时又要重新配一遍开发板管理器。安装路径我建议保持默认的C:\Program Files\Arduino IDE。有些人不喜欢把软件装 C 盘但如果改安装目录后续 Windows 防火墙弹窗、Windows 更新重置关联等情况下容易出现路径不一致的奇怪问题。IDE 本身体积不大占用不了多少空间。2.2 驱动问题CH340、CP2102 与“无法识别的 USB 设备”绝大多数 Arduino 板子无论是官方 Uno、Nano还是国内的兼容板、NodeMCUESP8266都是通过 USB 转串口芯片和电脑通信的。常见的方案有两种CH340 国产芯片和 CP2102 硅谷芯片。官方原装板一般用 ATmega16U2 做 USB 转串口系统免驱直接识别但兼容板为了省成本几乎清一色 CH340。如果你把板子插上电脑设备管理器里看到一个带黄色感叹号的“USB 2.0-Serial”或者干脆显示“无法识别的 USB 设备”大概率就是 CH340 驱动没装。这时别去 Windows 更新里找驱动老老实实去芯片厂家的官网或知名的驱动站下载对应版本。CH340 在 Windows 10/11 上理论上可以自动联网安装但国内网络环境下经常失败手动装一次最省心。提示插上板子之前先确认线材是数据线而不是只能充电的线。这个坑我见过太多人踩换了三四根线才发现是被线材坑了。2.3 首次烧录的权限检查防火墙与驱动签名安装完成后首次打开 Arduino IDEWindows Defender 防火墙一般会弹窗询问是否允许访问网络。这个务必允许因为 IDE 需要联网下载库索引、检查开发板平台更新禁止了后面添加库和 JSON 地址都可能出问题。另外有极少数情况CH340 驱动在 64 位系统上会被提示“驱动程序无法验证发布者”这是驱动签名问题。解决方法是临时禁用驱动签名强制——开机时按 F8 进入高级启动选项选择“禁用驱动程序签名强制”然后重新安装驱动。装好后建议再恢复默认设置否则系统长期处于弱签名校验状态不安全。到这里Windows 下的环境就搭好了。打开 IDE插上板子选择正确的板卡型号和串口号烧录一个 Blink 例程试试。如果连续报错 avrdude 找不到端口回到设备管理器确认 COM 口号并检查是否和蓝牙虚拟串口占用了同一编号。3. macOS 平台安装方式选择、权限放行与串口识别macOS 上的 Arduino IDE 安装比 Windows 要清爽一点但很多新用户会被系统权限和串口列表为空这两个问题搞到心态崩溃。这一节我把从下载到跑通 Blink 的完整路径说清楚顺带聊一下 Apple Silicon 和 Intel 芯片的差异。3.1 安装包方式与 Homebrew 方式怎么选Arduino IDE 官网为 macOS 提供 dmg 安装包和 zip 免安装包两种格式。绝大多数情况下直接下 dmg双击后把 Arduino IDE.app 拖到 Applications 文件夹就完成了简单直接。如果你熟悉 Homebrew也可以走brew install --cask arduino-ide命令行安装。这种方式的好处是升级方便一条命令就能完成配置文件的路径也不变坏处是 Homebrew 安装时走的是自带镜像下载速度可能不稳定而且 cask 版本的发布有时会滞后几天。日常使用我建议直接官网下载 dmg 就好没必要为了一条命令多折腾。Apple Silicon 芯片的 Mac 用户请确认官网下载的是 Apple Silicon 专用版本不是啃老的 Intel 版。虽然 Rosetta 2 转译后也能运行但安装的是 ARM 原生版本时后续跑 ESP32 编译器、OpenOCD 下载器的原生工具链会明显更快没必要给自己埋这个性能隐患。3.2 三处系统权限缺一处串口都连不上macOS 对硬件的权限管控比 Windows 严格得多安装完 IDE 后还要开放三个位置。第一处是“系统设置”里的“隐私与安全性”。如果安装时提示“无法打开因为无法验证开发者”右键点击 App 图标选择“打开”系统会再次弹窗这次会出现“仍要打开”的按钮点它就能放行。新版 macOS 有时候叫法不同但路径逻辑是一致的。第二处是“完全磁盘访问权限”。这个严格来说不是必需的但最好给 Arduino IDE 加上。原因很简单串口监视器功能需要访问/dev/tty.*和/dev/cu.*设备节点有些项目的编译输出还会写到临时目录不放行的话偶尔会出现诡异的读取失败。系统设置 → 隐私与安全性 → 完全磁盘访问权限把 Arduino 加进去然后重启 IDE。别嫌麻烦这一步能省掉后续很多玄学问题。第三处是开发板接入后首次弹出的“要允许此电脑访问可移动卷宗吗”或“Arduino IDE 想要访问串口设备”的授权弹窗必须点击允许。如果你手滑点成了不允许去“系统设置 → 隐私与安全性 → 开发者工具”里检查确保 Arduino IDE 在列表中且开关是打开的。注意macOS Sonoma 及更新版本对串口权限的提示可能会藏在“隐私与安全性”底部往下滚动才能看到别只盯着顶部找。3.3 串口列表为空大部分情况下不是 IDE 的错Mac 上串口识别失败的常见原因有三个USB 线只供电不传数据、CH340 驱动版本不匹配、权限没给到位。前两个是硬伤第三个可以通过终端检查。打开“终端”程序输入ls /dev/tty.*回车。如果能看到类似/dev/tty.usbserial-1420的字样说明系统层面已经识别到串口问题出在 IDE 权限上。如果完全没有输出先把线换一根再考虑驱动。CH340 在 Mac 上比较挑剔装完驱动后记得重启一次电脑否则驱动不会加载。另外一个小技巧macOS 的串口监视器默认波特率是 9600如果你的项目里用的传感器或 ESP32 程序设置了不同的波特率串口监视器里调一下右下角的波特率选择器就好不需要改代码。4. Linux 平台发行版差异、udev 规则与终端权限Linux 安装 Arduino IDE 的过程不复杂但坑非常典型不同发行版的包管理器不同AppImage 缺依赖串口权限总是被卡。再加上“国产 Linux 发行版”近年来使用人数变多还需要额外考虑库源和依赖兼容性。这节我把覆盖场景尽量展开。4.1 通用安装AppImage 或 tar.xz不要只依赖发行版仓库Arduino 官网给 Linux 提供两种通用格式AppImage 和 tar.xz 压缩包。AppImage 是一个直接可执行的文件比较接近 Windows 上的绿色软件tar.xz 解压后目录里有一个arduino-ide可执行文件直接运行即可。先解释一下为什么我不建议直接apt install arduino。Debian/Ubuntu 软件源里的 Arduino 版本通常落后官方很多不仅是 IDE 2.x 没跟上甚至可能还是 1.0.x 时代的古董对 ESP32/ESP8266 的支持也很残缺。自己动手从官网下载能保证每次拿到的都是最新稳定版。AppImage 格式要注意运行之前先给执行权限命令是chmod x ArduinoIDE.AppImage然后双击或在终端里运行。如果你用的是 Ubuntu 22.04 及之后的版本AppImage 会提示缺libfuse2这是因为新版系统换成了 FUSE3。解决方法是sudo apt install libfuse2装完重新运行就好。tar.xz 版本更让人省心解压后不需要额外依赖只要系统有图形环境就能运行。我的习惯是把解压后的目录放在~/apps/arduino-ide再创建一个桌面快捷方式指向可执行文件启动速度比 AppImage 稍快一点。4.2 udev 规则解决“端口不可用”的核心步骤Linux 下把 Arduino 板子插上打开 IDE端口列表经常是空的。这不是 IDE 坏了也不是板子坏了而是当前用户没有访问串口设备的权限。查看端口可以用ls /dev/ttyUSB*或ls /dev/ttyACM*。如果能看到设备文件说明系统识别到了但 IDE 读不到那就是权限问题。解决方法是把当前用户加入 dialout 组sudo usermod -aG dialout $USER修改完之后必须重新登录系统或者重启组权限才会生效。如果这个操作做了还是不行就需要写 udev 规则在/etc/udev/rules.d/目录下创建一个文件比如99-arduino.rules内容按板子的 USB VID/PID 写SUBSYSTEMtty, ATTRS{idVendor}1a86, ATTRS{idProduct}7523, MODE0666, GROUPdialout这里的1a86:7523是 CH340 芯片的常见 VID/PID如果你的板子是 CP2102则对应的 VID/PID 通常是10c4:ea60。写完保存后执行sudo udevadm control --reload-rules和sudo udevadm trigger重新插拔板子。之后 IDE 里就能正常看到端口了。4.3 在 WSL 里运行的注意事项不少人在 Windows 上装了 WSLWindows Subsystem for Linux想在里面跑 Arduino IDE。理论上是可行的但有几个硬性问题需要先想清楚。首选方案是安装 WSLg 支持的版本比如 Ubuntu 22.04 里sudo apt install wslg这样 IDE 的图形界面可以直接弹出来不需要额外配置 X Server。但串口透传是坑Windows 下的 COM 口不会自动出现在 WSL 的/dev目录里需要借助 usbipd-win 工具把 USB 设备附加到 WSL 中或者是直接放弃 WSL在 Windows 原生环境里跑 IDE。我给个个人建议除非你有明确的命令行编译需求比如要在 WSL 里配合脚本批量编译多个 ino 工程否则别把 Arduino 开发环境放在 WSL 里权限和 USB 透传的折腾成本远大于收益。另外顺带一提WSL 里跑编译任务时系统字体渲染和平常的 Linux 桌面有差异很多人会特意调等宽字体来提升代码阅读舒适度。我个人推荐在 WSL 或任何 Linux 桌面上使用“JetBrains Mono”或“Cascadia Code”它们对常见编程符号的区分度做得好中文注释也不会发虚。这个和 Arduino 环境没直接关系但对长期对着 IDE 写代码的人来说很值。5. 装完别急着写代码先处理语言、开发板管理器与下载提速三平台安装完成后还有几个收尾配置直接关系到你后面写代码的顺畅程度尤其是当你需要玩 ESP32/ESP8266 时第二步“开发板管理器地址”是绕不开的关键操作。这一节把安装之后的必要配置都过一遍。5.1 切换中文界面与初始设置的合理项Arduino IDE 2.x 默认是英文界面。切换中文的方法是File → Preferences在 Language 下拉框里选择“简体中文”重启 IDE 生效。如果你习惯英文界面也没问题但中文菜单对初学者友好一些至少查错误日志的时候更容易对上号。Preferences 里有几个选项我建议按需打开或关掉勾选“编译时显示详细输出”和“下载时显示详细输出”这样报错时能看到底层命令找问题比自己盲猜快得多。把“编辑器字号”调到 16 或 174K 屏或者高分辨率笔记本上默认字号偏小长期盯着看眼睛容易累。“自动保存”选项建议打开虽然 Arduino 工程一般不大但养成好习惯总没错。下载加速方面IDE 2.x 的库索引和编译工具链默认从官方服务器或 GitHub 拉取国内网络环境下偶尔会出现卡在“正在下载”的假死状态。最常见的解决办法是给 IDE 配置代理Preferences 里找到 Network 设置填入可用的 HTTP 代理地址和端口或者让系统走统一的代理环境变量。某些组织网络环境里也可以用国内的开源镜像站替换下载源这个要看具体镜像的配置说明不能一概而论。5.2 开发板管理器官方、ESP32、ESP8266 的管理细则不管是哪个平台开发板管理器的逻辑是相通的。点击左侧导航栏的“开发板管理器”图标一个芯片形状搜索你想用的开发板类型点击安装即可。官方支持的板子比如 Arduino Uno、Nano、Mega 2560在默认列表里直接搜名字安装就行。但 ESP32 和 ESP8266 不是官方板需要手动添加 JSON 地址。操作路径是File或 文件→ Preferences → 附加开发板管理器网址把下面两个地址粘贴进去如果你两个芯片都要玩就同时写用英文逗号分隔https://espressif.github.io/arduino-esp32/package_esp32_index.json https://arduino.esp8266.com/stable/package_esp8266com_index.json保存后回到开发板管理器搜索esp32或esp8266你会看到对应平台条目点 Install 等待下载完成。ESP32 平台的完整工具链比较大依赖于网络稳定如果你用的是国内网络第一次安装卡在 tools 下载阶段很常见。可以重复点几次重试有时候多试一次就过了。还有一个做法是先在 GitHub Actions 或可信第三方手工下载 tools 压缩包再通过 IDE 的“离线安装”方式手动指定但流程较长非必要不做优先考虑。提示NodeMCU、Wemos D1 Mini 都是 ESP8266 芯片的板子安装 ESP8266 平台后就能在板卡列表里找到对应型号。ESP32-S3 是最近很火的带 Wi-Fi 和 BLE 的型号安装 ESP32 平台后在板卡列表可以找到ESP32S3 Dev Module选它即可。5.3 库管理装库的正确姿势与搜不到时的替代方案写非入门级项目时基本都要依赖库。比如驱动 OLED 屏幕要U8g2玩 DHT11 温湿度传感器要DHT sensor library用 ESP32 连 MQTT 要PubSubClient。库的安装入口是左侧的“库管理器”搜索库名点 Install完事。有一个常见问题是搜不到某个库。很多情况是因为名字不精确比如 Adafruit 的很多库叫做Adafruit Unified Sensor、Adafruit DHT你光搜一个DHT第一屏出来的未必是自己想要的。另一个情况是第三方库没有上传到 Arduino 官方索引这个时候可以去 GitHub 上找库仓库下载 zip 包然后在 IDE 里选择 Sketch → Include Library → Add .ZIP Library手动导入。库文件装多了以后要注意依赖冲突问题。Arduino 库管理器不会自动处理版本兼容如果两个库都依赖同一个底层库的不同版本编译时就可能报重复定义或缺少函数声明之类的错。遇到这种问题可以在库管理器里逐一卸载不用的旧版本或者是手动改动库文件不推荐新手操作。保持“装一个用一个”的习惯能少掉很多头发。6. 多平台切换的正确姿势配置文件、工程目录与串口波特率备忘跨平台开发的需求在实际项目中很常见——白天在公司 Windows 机写代码晚上回家用 Mac 继续调试或者台式机是 Linux、外出带个 MacBook。Arduino IDE 在这方面还算厚道核心配置逻辑跨平台一致提前把它们梳理清楚切换成本几乎为零。6.1 各平台配置文件的存放位置Arduino IDE 的配置分成两部分全局配置和工程内配置。全局配置文件保存了开发板管理器地址、编辑器偏好、代理设置等。不同平台的位置分别是WindowsC:\Users\用户名\AppData\Roaming\ArduinoIDE\macOS/Users/用户名/Library/Arduino15/和~/Library/Application Support/arduino-ide/两个目录都有前者管编译工具链和平台后者管 IDE 设置Linux~/.arduino15/和~/.config/arduino-ide/如果你要迁移环境把上面这些目录打包带走新机器上展开后 IDE 基本能直接接续使用。但有一点要留意编译缓存和索引文件不要复制过去让它重新生成一次否则可能因为是不同平台来源导致索引损坏。6.2 Sketchbook 目录与工程组织的建议Arduino 的源码文件叫 sketch扩展名 .ino默认保存在“草图本目录”SketchbookPreferences 里可以查看和修改这个路径。多平台切换时我强烈建议把 Sketchbook 固定在云同步目录里比如 OneDrive、坚果云或 Git 仓库。虽然 Arduino 工程不大但云同步能保证你在任何电脑上打开的都是最新一份代码。需要注意Git 同步时记得忽略/build目录这是编译产物没必要纳入版本管理。工程目录的命名也有讲究。Arduino 要求 sketch 所在的文件夹名必须和 .ino 文件主名一致比如文件是Blink.ino文件夹就要叫Blink。不一致时 IDE 会提示“文件夹名与文件名不匹配”点确定后程序还是能跑但容易造成文件混乱别在这上面偷懒。6.3 串口监视器设置与开发过程中的快捷验证法写嵌入式代码时最常打交道的就是串口监视器。每个平台的快捷键不太一样但大多数设备都支持 CtrlShiftM 或 CmdShiftM 打开。串口监视器的波特率必须和代码里Serial.begin()设置一致否则看到的是满屏乱码。实际调试中我有一个固定流程先看板载 LED 是否闪烁通电和工作状态再看串口是否有正常打印。如果两者都没有多半是程序没烧进去或者板子根本没被识别如果板载 LED 正常但串口无输出先看波特率再看串口监视器窗口是否有额外板卡占用了同一个端口。多个 IDE 窗口同时打开同一个 COM 口也会导致无法打开串口的问题。另外一个加速开发的小技巧是把常用的编译和上传按钮的快捷键记下来Windows/Linux 是 CtrlR 和 CtrlUmacOS 是 CmdR 和 CmdU新版本的 2.x 还支持“上传前自动保存”设置里勾选后能少几次手动保存的手忙脚乱。7. 按芯片方案选择官方板、ESP8266、ESP32 的开发环境差异速查很多用户装完 IDE 后第一件事就是接自己的板子但 Arduino 世界早已不是只有 AVR 芯片的天下。不同的芯片方案在开发环境里对应的板卡列表、工具链复杂度、串口下载方式都有差异尤其是遇到 NodeMCU 和 ESP32-S3 这类热门型号时弄混一个选项就会导致编译上传失败。这一节按芯片方案列一个速查帮大家少走弯路。7.1 官方 AVR 板Uno、Nano、MegaAVR 系列是 Arduino 的开山鼻祖开发环境最简单。安装官方 AVR 平台后板卡列表里直接选 Arduino Uno对应 ATmega328P或 Arduino Mega对应 ATmega2560选择正确的串口号点击上传即可。这类板的编译工具链是 avr-gcc对电脑性能要求很低树莓派上跑都毫无压力。Windows 和 macOS 下唯一要留意的是如果 USB 口连接的是一些国内兼容板还是那套 CH340 驱动问题。另外一个容易忽略的点是部分新版 Nano 使用 USB-C 接口接线时确认线缆支持数据传输而不是只有充电功能。7.2 ESP8266 方案NodeMCU、Wemos D1 MiniESP8266 的板子虽然也能在 Arduino IDE 里开发但本质上是把 Arduino 框架“移植”到了这颗 Wi-Fi 芯片上所以安装平台时就要特别注意细节。在板卡列表里选择NodeMCU 1.0 (ESP-12E Module)或LOLIN(WEMOS) D1 Mini Pro设置里有一项Flash Size和Reset Mode在某些型号下要匹配 bootloader 的分区表选错的结果通常是编译能通过但上传后系统起不来、串口死循环打印乱码。ESP8266 上传速度默认在 115200 或 460800老版本的板子 bootloader 不支持太高的波特率。如果上传中途报同步失败把波特率降一档再试。这个问题在 NodeMCU 高频率版上尤其常见网上很多“烧录失败”的求助帖最后都是这个原因。7.3 ESP32 全系列含 ESP32-S3、C3ESP32 的开发环境相对更重一些因为它的 SDK 和工具链大很多。安装好 ESP32 平台后板卡列表里能看到几十种官方设计选择时先确认你的板子主控芯片具体型号。比如常见的 ESP32 DevKit V1 一般是ESP32 Dev ModuleESP32-S3 系列选择ESP32S3 Dev ModuleESP32-C3 选ESP32C3 Dev Module。ESP32 系列在 IDE 里的一个常见配置项是Partition Scheme。默认分区表只给 Arduino 程序分了约 1.2MB 的 flash 空间如果你用的是 ESP32-S3 做超长字符串的 Web Server 或 OTA 升级建议手动切换到Huge APP (3MB No OTA)或按需选择。这个设置在板卡选择器附近的下拉菜单里位置不算显眼但影响很大。上传方式上ESP32 通常通过USB Serial/JTAG针对 S3、C3或 UART依靠外部串口芯片两种方式。如果你的板子没有外置串口芯片部分 S3 开发板直接用原生 USB 口在 IDE 里可能会识别为两个 COM 口选带USB Serial/JTAG字样的那个上传时需要按住板上的 BOOT 键再按复位进入下载模式很多 ESP32-S3 新手第一次上传失败都是因为这一步。7.4 不同平台同一块板子的“玄学”差异最后说个很实际的观察同一块 ESP32 开发板在 Windows 下正常上传换到 Mac 或 Linux 下可能出现无法识别端口或上传超时。这不是 IDE 的问题通常是这几方面差异导致操作系统对 USB 串口的枚举名称不同、CH340 驱动版本在不同平台的表现不一致、以及 macOS 的权限提示被忽略。排查顺序建议是先换数据线排除物理层再看串口列表有没有识别到设备排除驱动层最后确认板卡型号是否选对排除配置层。以 ESP32-S3 为主力开发板的朋友我还要特别提醒它的 USB 原生串口在低功耗模式下偶尔会断开IDE 串口监视器显示“disconnected”这时候重新插拔一次 USB 线就能恢复几乎不用重启 IDE也不要去反复点“Connect”。8. 安装收尾后的例行验证三步确认环境真正可用环境搭得再完整最终要运行一个真实程序验证心里才踏实。我知道很多人装完 IDE 会随手写一句void setup() { Serial.begin(9600); }然后跑去抱怨“为什么串口监视器没输出”——因为那 10 行代码根本没上传到板子上。为了避免这种基础错误我把验证流程固定成了三步每次新配环境都这么做。8.1 验证编译用系统自带的 Blink 例程无论哪个平台安装包里都自带一个 Blink 例程。在 IDE 里选择 File → Examples → 01.Basics → Blink这时不用急着插板子直接点“验证”对勾图标等待编译器完成。如果编译通过说明 IDE、开发板平台、工具链都正常。这一步也能排除很多“IDE 打不开”“库索引损坏”等误导性的坑看到底部的“编译完成”提示后面的操作才谈得上排查价值。不同开发板平台的编译时间差异很大。AVR 板一两秒就完成ESP32 平台第一次编译可能要等一两分钟甚至更久因为需要预处理 ESP-IDF 的组件依赖。这些过程中看到 IDE 卡在某个百分比暂停一段时间是正常的别急于强杀进程。8.2 验证上传连接板子并选择正确端口编译通过后把开发板用数据线连接到电脑等待系统识别串口。在 IDE 的板卡选择器里选择具体的板卡型号然后在“端口”下拉菜单里选择识别到的 COM 口或/dev/cu.*设备。如果端口列表是空的回到前面对应平台的排错段落找原因。选择好后点击“上传”如果一切正常IDE 底部会显示“上传成功”。上传成功后观察板子上的 LED 是否以例程里设置的频率闪烁。如果 LED 不亮先确认代码里设置的是板载 LED 引脚而不是随意写一个数字。不同开发板的板载 LED 引脚各不相同比如 Uno 是 13NodeMCU 是 D0GPIO16ESP32 开发板一般是 2。弄混引脚名是所有新手的必经之路不丢人查一下板子原理图就好。8.3 验证串口通信打开监视器查看输出Blink 例程不打印串口数据所以验证串口还要换一个程序或者手动在 Blink 里加几行Serial.println(Hello Arduino);。打开串口监视器把波特率调到 9600应该能看到打印信息。如果看到乱码多半是电脑上的监视器波特率和代码里的设置不一致。如果监视器一直空白但上传时报“上传成功”大概率是复位时序问题部分板子上传后需要手动按一下复位键才能开始运行新程序。提示Arduino IDE 2.x 的串口监视器支持多行输入发送窗口里回车默认会发送“换行”字符。如果你的串口解析程序依赖\r\n结尾记得在右下角把“换行符”选项调成“两者都”或“回车 换行”省得莫名其妙收不到完整数据。这三步走完这套开发环境就算真正“可靠”了。之后无论切换到哪个平台、哪块开发板我都建议按这个流程重新验证一遍因为每个电脑的驱动状态、权限配置都不完全一样跑通一个最小闭环比直接上手复杂项目要靠谱得多。