Arduino IDE 安装教程：Windows/macOS/Linux 开发环境搭建

一、前言

Arduino 是一套非常流行的开源电子开发平台，广泛应用于：

Arduino UNO / Mega / Nano 等开发板
ESP32 / ESP8266
传感器开发
智能家居
物联网设备
LED、OLED、LCD 屏幕
机器人
各类 DIY 硬件项目

如果想给 Arduino 或 ESP32 开发板烧录程序，通常需要先安装 Arduino IDE。

目前官方推荐使用 Arduino IDE 2.x，相比早期的 Arduino IDE 1.x，IDE 2.x 提供了更加现代化的编辑器、代码补全、代码导航以及调试等功能。Arduino 官方软件下载页面目前提供 Arduino IDE 2.3.10。

官方下载地址：

https://www.arduino.cc/en/software/

本教程以 Arduino IDE 2.x 为例，Windows 用户优先推荐使用安装包方式安装。

二、Arduino IDE 是什么？

Arduino IDE（Integrated Development Environment）是 Arduino 官方提供的集成开发环境。

简单来说，它主要负责：

text 复制代码

编写代码
   ↓
代码编译
   ↓
生成固件
   ↓
连接开发板
   ↓
上传程序
   ↓
开发板运行程序

例如最经典的 LED 闪烁程序：

cpp 复制代码

void setup() {
  pinMode(LED_BUILTIN, OUTPUT);
}

void loop() {
  digitalWrite(LED_BUILTIN, HIGH);
  delay(1000);

  digitalWrite(LED_BUILTIN, LOW);
  delay(1000);
}

使用 Arduino IDE 编译并上传以后，开发板上的 LED 就可以按照程序运行。

三、下载 Arduino IDE

3.1 进入官方下载页面

打开 Arduino 官方软件下载页面：

https://www.arduino.cc/en/software/

进入页面以后，可以看到：

text 复制代码

Arduino IDE

目前官方页面提供：

Windows
macOS
Linux
Windows ZIP
Windows MSI
Linux AppImage
Linux ZIP

等不同版本。

官方软件下载页面：

https://www.arduino.cc/en/software/

建议尽量从 Arduino 官方网站下载，不建议从第三方软件下载站下载，以避免安装包被修改或者捆绑其他软件。

四、Windows 安装 Arduino IDE

4.1 下载 Windows 版本

如果使用 Windows 10 / Windows 11 电脑，选择：

text 复制代码

Windows 10 and newer

下载对应的 Arduino IDE 安装程序。

Arduino 官方目前支持：

text 复制代码

Windows 10（64 位）及以上

下载完成以后，一般会得到类似：

text 复制代码

arduino-ide_2.3.10_Windows_64bit.exe

这样的安装文件。

实际文件名会随着版本更新而变化。

五、开始安装

找到刚刚下载的 .exe 文件。

例如：

text 复制代码

arduino-ide_2.3.10_Windows_64bit.exe

双击运行。

如果 Windows 弹出：

text 复制代码

用户账户控制

是否允许此应用对你的设备进行更改？

点击：

text 复制代码

是

即可。

六、接受许可证协议

安装程序启动以后，会出现 Arduino IDE 的安装界面。

点击：

text 复制代码

I Agree

接受许可协议。

七、选择安装用户

通常会看到类似：

text 复制代码

Install for:

○ Anyone who uses this computer
○ Only for me

一般直接选择默认选项即可。

如果电脑只有自己使用，可以选择：

text 复制代码

Only for me

如果希望所有 Windows 用户都可以使用 Arduino IDE，可以选择：

text 复制代码

Anyone who uses this computer

然后点击：

text 复制代码

Next

八、选择安装目录

接下来选择 Arduino IDE 的安装位置。

例如：

text 复制代码

C:\Program Files\Arduino IDE

直接使用默认路径即可。

如果系统盘空间比较紧张，也可以修改到其他磁盘，例如：

text 复制代码

D:\Software\Arduino IDE

然后点击：

text 复制代码

Install

开始安装。

九、等待安装完成

安装程序会自动完成：

Arduino IDE 文件安装
开发环境配置
必要组件安装
Windows 相关配置

等待进度条完成即可。

安装完成后点击：

text 复制代码

Finish

如果看到：

text 复制代码

Run Arduino IDE

可以保持勾选，这样安装完成以后会自动启动 Arduino IDE。

十、启动 Arduino IDE

安装完成后，可以通过以下方式启动 Arduino IDE。

方法一：开始菜单

打开：

text 复制代码

开始菜单

搜索：

text 复制代码

Arduino IDE

然后点击启动。

方法二：桌面快捷方式

如果安装过程中创建了桌面快捷方式，可以直接双击：

text 复制代码

Arduino IDE

十一、第一次启动

第一次打开 Arduino IDE 2.x 时，需要等待软件完成初始化。

首次启动可能会进行：

text 复制代码

Loading...
Initializing...
Downloading...

等操作。

第一次启动时间可能比后续启动稍长。

这是正常现象。

十二、Arduino IDE 界面介绍

Arduino IDE 2.x 的界面主要可以分成几个区域。

text 复制代码

┌──────────────────────────────────────┐
│ 菜单栏                               │
├────────┬─────────────────────────────┤
│        │                             │
│ 工具栏 │        代码编辑区域          │
│        │                             │
│        │                             │
├────────┴─────────────────────────────┤
│              输出 / 日志              │
└──────────────────────────────────────┘

常用功能主要包括：

1. 编译

用于检查代码是否存在错误。

按钮通常是：

text 复制代码

Verify

也就是：

text 复制代码

✓

2. 上传

用于把程序上传到开发板。

按钮通常是：

text 复制代码

Upload

也就是：

text 复制代码

→

3. 串口监视器

可以查看开发板通过串口输出的数据。

例如：

cpp 复制代码

Serial.begin(115200);

Serial.println("Hello Arduino");

然后可以在 Serial Monitor 中看到：

text 复制代码

Hello Arduino

十三、连接 Arduino 开发板

安装完成以后，将 Arduino 开发板通过 USB 数据线连接到电脑。

例如：

text 复制代码

电脑
 │
 │ USB
 ↓
Arduino UNO

Windows 会自动识别开发板。

注意：USB 数据线必须支持"数据传输"，部分便宜的数据线只有充电功能。

如果使用的是 ESP32、ESP8266 等第三方开发板，后面还需要安装对应的开发板支持包。

十四、选择开发板

连接开发板以后，在 Arduino IDE 中找到开发板选择区域。

选择：

text 复制代码

Select Board

然后选择对应的开发板。

例如 Arduino UNO：

text 复制代码

Arduino UNO

如果电脑连接了多个开发板，还需要选择正确的串口。

例如：

text 复制代码

COM3
COM5
COM8

十五、查看 Windows 串口

如果不知道自己的开发板对应哪个 COM 口，可以打开：

text 复制代码

设备管理器

Windows 快捷键：

text 复制代码

Win + X

然后选择：

text 复制代码

设备管理器

找到：

text 复制代码

端口（COM 和 LPT）

例如：

text 复制代码

USB-SERIAL CH340 (COM3)

或者：

text 复制代码

USB-SERIAL CH340 (COM5)

这里的：

text 复制代码

COM3

就是当前开发板使用的串口。

十六、第一次运行 Blink 示例

Arduino IDE 自带了很多官方示例程序。

可以打开：

text 复制代码

File
  ↓
Examples
  ↓
01.Basics
  ↓
Blink

打开 Blink 示例。

代码类似：

cpp 复制代码

void setup() {
  pinMode(LED_BUILTIN, OUTPUT);
}

void loop() {
  digitalWrite(LED_BUILTIN, HIGH);
  delay(1000);

  digitalWrite(LED_BUILTIN, LOW);
  delay(1000);
}

十七、编译程序

首先点击：

text 复制代码

Verify

也就是左上角的：

text 复制代码

✓

Arduino IDE 会开始编译。

如果最终出现：

text 复制代码

Done compiling.

或者类似：

text 复制代码

Compilation completed successfully.

说明代码编译成功。

十八、上传程序

确认开发板和 COM 端口选择正确以后，点击：

text 复制代码

Upload

Arduino IDE 会执行：

text 复制代码

编译
 ↓
连接开发板
 ↓
上传固件
 ↓
自动复位
 ↓
运行程序

如果上传成功，可以看到类似：

text 复制代码

Done uploading.

十九、观察 LED

如果使用 Arduino UNO 等开发板，Blink 程序上传成功以后，可以看到板载 LED 开始：

text 复制代码

亮
 ↓
1秒
 ↓
灭
 ↓
1秒
 ↓
亮
 ↓
循环

至此，Arduino IDE 安装和开发环境基本配置完成。

二十、ESP32 用户需要额外注意

如果使用的是 ESP32，例如：

text 复制代码

ESP32-WROOM-32
ESP32-WROOM-32E
ESP32 DevKit

Arduino IDE 默认并不会直接提供 ESP32 的开发板支持。

需要额外安装：

text 复制代码

ESP32 Board Package

安装完成以后，Arduino IDE 才可以识别 ESP32。

大致流程：

text 复制代码

Arduino IDE
    ↓
Preferences
    ↓
Additional Boards Manager URLs
    ↓
添加 ESP32 开发板地址
    ↓
Boards Manager
    ↓
安装 ESP32
    ↓
选择 ESP32 开发板

例如常见 ESP32 开发板可以选择：

text 复制代码

ESP32 Dev Module

二十一、Arduino IDE 中安装开发板

打开：

text 复制代码

Tools
    ↓
Board
    ↓
Boards Manager

或者直接使用左侧的开发板管理功能。

然后搜索：

text 复制代码

ESP32

根据实际开发板安装对应的 Board Package。

安装完成以后重新选择：

text 复制代码

Tools
    ↓
Board

即可看到 ESP32 相关开发板。

二十二、Arduino IDE 中安装库

Arduino 开发过程中经常需要安装第三方库。

例如：

text 复制代码

OLED
LCD
传感器
WiFi
Bluetooth
MQTT
HTTP
JSON

可以打开：

text 复制代码

Tools
    ↓
Manage Libraries

搜索需要的库。

例如：

text 复制代码

Adafruit SSD1306

然后点击：

text 复制代码

Install

即可。

二十三、常见问题

1. Arduino IDE 找不到开发板

首先检查：

text 复制代码

USB 数据线

是否支持数据传输。

然后检查：

text 复制代码

设备管理器

是否出现：

text 复制代码

COMx

如果没有出现，可能需要安装 USB 转串口驱动。

常见芯片包括：

text 复制代码

CH340
CP210x
FT232

不同开发板使用的 USB 转串口芯片可能不同。

二十四、找不到 COM 端口怎么办？

可以按照下面的顺序排查：

第一步

拔掉开发板。

第二步

打开：

text 复制代码

设备管理器

第三步

重新插入开发板。

第四步

观察：

text 复制代码

端口（COM 和 LPT）

是否出现新的设备。

如果出现：

text 复制代码

COM3

说明电脑已经识别到串口。

如果完全没有变化：

text 复制代码

优先检查 USB 数据线

二十五、上传程序失败怎么办？

常见原因包括：

原因一：开发板选择错误

例如实际使用 ESP32，却选择了：

text 复制代码

Arduino UNO

需要重新选择正确的 Board。

原因二：COM 口选择错误

例如开发板实际使用：

text 复制代码

COM5

但是 IDE 选择了：

text 复制代码

COM3

需要重新选择端口。

原因三：USB 数据线问题

部分 USB 线只有充电功能。

建议直接换一根确认支持数据传输的 USB 数据线。

原因四：开发板驱动问题

如果设备管理器中出现：

text 复制代码

未知设备

或者：

text 复制代码

USB Serial

带黄色感叹号，需要检查对应 USB 转串口芯片的驱动。

二十六、Arduino IDE 安装目录在哪里？

Windows 下 Arduino IDE 2.x 常见安装目录包括：

text 复制代码

C:\Program Files\Arduino IDE

如果选择了"仅当前用户安装"，则可能位于：

text 复制代码

C:\Users\用户名\AppData\Local\Programs\Arduino IDE

不同安装方式对应的路径可能不同。

二十七、Arduino IDE 1.x 还需要安装吗？

一般不需要。

目前新项目建议优先使用：

text 复制代码

Arduino IDE 2.x

Arduino 官方仍然提供：

text 复制代码

Arduino IDE 1.8.19

作为 Legacy IDE。

只有在一些比较老的项目、老插件或者旧开发环境存在兼容性要求时，才建议考虑 Arduino IDE 1.x。

二十八、Arduino IDE 和 Arduino CLI 的区别

Arduino 官方还提供：

text 复制代码

Arduino CLI

它主要用于命令行环境。

简单理解：

工具	主要用途
Arduino IDE	图形化开发
Arduino CLI	命令行开发
Arduino Cloud	云端开发
Arduino IDE 1.x	老版本开发环境
Arduino IDE 2.x	当前主流开发环境

普通开发者直接使用：

text 复制代码

Arduino IDE 2.x

即可。

二十九、安装完成后的完整开发流程

Arduino 开发最常见的流程就是：

text 复制代码

安装 Arduino IDE
        ↓
连接开发板
        ↓
安装开发板支持包
        ↓
选择 Board
        ↓
选择 COM Port
        ↓
编写代码
        ↓
Verify 编译
        ↓
Upload 上传
        ↓
开发板运行
        ↓
Serial Monitor 调试

如果使用 ESP32，则一般变成：

text 复制代码

Arduino IDE
      ↓
安装 ESP32 Board Package
      ↓
连接 ESP32
      ↓
选择 ESP32 Dev Module
      ↓
选择 COM 端口
      ↓
编写程序
      ↓
编译
      ↓
上传
      ↓
运行

三十、总结

Arduino IDE 是 Arduino、ESP32 等开发板非常常用的开发工具。

对于新手来说，推荐直接安装：

text 复制代码

Arduino IDE 2.x

官方下载地址：

https://www.arduino.cc/en/software/

安装完成以后，只需要掌握下面几个核心操作：

text 复制代码

1. 安装 Arduino IDE
2. 连接开发板
3. 安装对应 Board Package
4. 选择 Board
5. 选择 COM Port
6. 编译代码
7. 上传代码
8. 使用 Serial Monitor 调试

如果是 Arduino UNO，可以直接从 Blink 示例开始。

如果是 ESP32，则需要进一步安装 ESP32 Board Package，之后就可以使用 Arduino IDE 开发 Wi-Fi、Bluetooth、GPIO、OLED、传感器等项目。

参考资料

Arduino 官方软件下载页面：https://www.arduino.cc/en/software/
Arduino 官方软件文档：https://docs.arduino.cc/software/
Arduino IDE 官方安装说明：https://support.arduino.cc/hc/en-us/articles/360019833020-Download-and-install-Arduino-IDE
Arduino 官方论坛：https://forum.arduino.cc/

本文基于 Arduino 官方当前提供的 Arduino IDE 2.x 版本整理，软件版本和安装界面可能会随着后续版本更新而发生变化。