跳到主要内容

环境搭建

本章将指导你完成 Arduino 开发环境的搭建，包括 IDE 安装、驱动配置和第一个程序的上传验证。

Arduino IDE 安装​

Arduino IDE 是官方提供的集成开发环境，支持 Windows、macOS 和 Linux。

下载安装​

  1. 访问 Arduino 官网下载页面
  2. 根据你的操作系统选择对应版本
  3. 下载并运行安装程序

Windows 安装步骤​

  1. 下载 Windows Win 10 and newer 版本（或 ZIP 免安装版）
  2. 运行安装程序，按提示完成安装
  3. 安装过程中会提示安装驱动程序，务必选择安装

macOS 安装步骤​

  1. 下载 macOS Apple Silicon 或 Intel 版本
  2. 将 Arduino IDE 拖入 Applications 文件夹
  3. 首次运行需要在系统偏好设置中允许打开

Linux 安装步骤​

# Ubuntu/Debian
sudo apt update
sudo apt install arduino

# 或者下载 AppImage 直接运行
chmod +x arduino-ide_*.AppImage
./arduino-ide_*.AppImage

IDE 界面介绍​

打开 Arduino IDE 后，你会看到以下主要区域：

┌─────────────────────────────────────────┐
│  菜单栏  文件  编辑  项目  工具  帮助      │
├─────────────────────────────────────────┤
│  [验证] [上传] [新建] [打开] [保存]      │
├─────────────────────────────────────────┤
│                                         │
│           代码编辑区                     │
│                                         │
│  void setup() {                        │
│    // put your setup code here          │
│  }                                      │
│                                         │
│  void loop() {                         │
│    // put your main code here           │
│  }                                      │
│                                         │
├─────────────────────────────────────────┤
│  状态信息：编译中...                      │
├─────────────────────────────────────────┤
│  串口监视器 [打开]  波特率: 9600         │
└─────────────────────────────────────────┘

常用菜单功能​

菜单功能说明
文件新建、打开、保存项目；示例程序
编辑代码编辑操作，如注释/取消注释
项目加载库、添加文件
工具选择开发板、端口、串口监视器
帮助官方文档、参考信息

驱动安装与板子连接​

连接开发板​

  1. 使用 USB 数据线连接 Arduino 和电脑
  2. 观察开发板上的电源指示灯（PWR/ON）是否亮起
  3. 板载 LED（通常标记为 L）可能会闪烁，表示有默认程序在运行

驱动安装​

Windows​

  • 官方 Arduino 板通常使用 CH340 或 ATmega16U2 芯片
  • 安装 IDE 时一般会自动安装驱动
  • 如未自动安装，可在设备管理器中手动更新驱动

macOS​

  • 系统通常会自动识别
  • 部分国产板需要安装 CH340 驱动： 
    # 使用 Homebrew 安装
    brew tap adrianmihalko/ch340g-ch34g-ch34x-mac-os-x-driver
    brew install --cask wch-ch34x-usb-serial-driver

Linux​

  • 通常无需额外驱动
  • 可能需要将用户添加到 dialout 组： 
    sudo usermod -a -G dialout $USER
    # 注销并重新登录生效

选择开发板和端口​

在 IDE 中配置你的开发板：

  1. 选择开发板：工具 → 开发板 → Arduino AVR Boards → Arduino Uno
  2. 选择端口：工具 → 端口 → 选择对应的 COM 端口（Windows）或 /dev/ttyUSB0（Linux/macOS）
如何确定端口
  • Windows：在设备管理器中查看"端口(COM和LPT)"
  • macOS：在终端运行 ls /dev/tty.*
  • Linux：在终端运行 ls /dev/ttyUSB*

让我们上传经典的 Blink 程序，验证环境配置是否正确。

打开示例程序​

  1. 文件 → 示例 → 01.Basics → Blink
  2. IDE 会自动打开 Blink 示例代码

代码解析​

/*
  Blink

  让板载 LED 点亮一秒，熄灭一秒，循环往复。

  大多数 Arduino 开发板的引脚 13 都连接了一个 LED。

  这是公共领域代码（Public Domain）。
*/

// setup 函数在开发板复位或上电时运行一次
void setup() {
  // 将数字引脚 13 初始化为输出
  pinMode(LED_BUILTIN, OUTPUT);
}

// loop 函数会无限循环运行
void loop() {
  digitalWrite(LED_BUILTIN, HIGH);  // 点亮 LED（高电平）
  delay(1000);                      // 等待 1 秒
  digitalWrite(LED_BUILTIN, LOW);   // 熄灭 LED（低电平）
  delay(1000);                      // 等待 1 秒
}

编译和上传​

  1. 验证代码：点击工具栏的 ✓（验证）按钮，或按 Ctrl+R

    • 底部状态栏显示"正在编译项目..."
    • 编译成功后显示"编译完成"

  2. 上传程序：点击工具栏的 →（上传）按钮，或按 Ctrl+U

    • 状态栏显示"正在编译项目..."
    • 然后显示"正在上传..."
    • 开发板的 TX/RX 指示灯会快速闪烁
    • 上传成功后显示"上传完成"

  3. 观察结果：

    • 板载 LED（标记为 L）开始每秒闪烁一次
    • 这表示程序成功上传并运行！

故障排除​

上传失败​

错误信息：avrdude: stk500_getsync() attempt 1 of 10: not in sync

可能原因和解决方法：

  1. 端口选择错误

    • 检查 工具 → 端口 是否选择了正确的端口
    • 尝试拔掉 USB 线重新连接，观察哪个端口消失/出现

  2. 开发板选择错误

    • 确认 工具 → 开发板 选择了正确的型号

  3. 驱动问题

    • 检查设备管理器（Windows）或系统信息（macOS）
    • 重新安装驱动程序

  4. USB 线问题

    • 确保使用的是数据线而非充电线
    • 尝试更换 USB 端口或数据线

编译错误​

错误信息：expected ';' before '}' token

解决方法：

  • 检查代码中是否缺少分号 ;
  • 检查括号是否配对
  • 检查函数名拼写是否正确

Arduino IDE 2.x（新版推荐）​

Arduino IDE 2.x 是 Arduino 官方推出的新一代开发环境，采用全新的架构重写，相比经典版 IDE 1.x 有显著的性能提升和功能增强。

IDE 2.x 与 IDE 1.x 对比​

特性IDE 1.x（经典版）IDE 2.x（新版）
界面Java Swing现代化界面
代码补全无智能补全
代码调试无内置调试器
编译速度较慢更快
串口监视器独立窗口集成标签页
云同步无Arduino Cloud 同步
自动格式化基础改进的格式化

IDE 2.x 主要功能​

侧边栏​

新版 IDE 采用侧边栏设计，常用功能触手可及：

  • 验证/上传：编译和上传代码到 Arduino 开发板
  • 开发板选择器：自动检测连接的开发板和端口
  • 项目文件夹：管理本地项目，支持云同步
  • 开发板管理器：安装 Arduino 和第三方开发板包
  • 库管理器：浏览和安装数千个库
  • 调试器：实时测试和调试程序
  • 搜索：在代码中搜索关键词
  • 串口监视器：查看串口输出数据

智能代码补全​

IDE 2.x 提供智能代码补全功能，帮助你更快地编写代码。输入时会自动提示可用的函数、变量和库：

// 输入 Serial. 后会自动列出可用方法
Serial.begin(9600);
Serial.print("Hello");
// 输入 digital 后会提示 digitalWrite, digitalRead 等
注意

代码补全需要先选择开发板型号才能正常工作。

内置调试器​

IDE 2.x 内置调试功能，支持设置断点、单步执行、查看变量值等。这对于排查复杂问题非常有帮助。

支持的调试方式：

  • 软件调试：通过串口输出调试信息
  • 硬件调试：使用调试探针（如 J-Link）进行硬件调试

串口绘图器​

串口绘图器可以将数据可视化显示为图形，非常适合监测传感器数据变化：

void loop() {
  int sensorValue = analogRead(A0);
  
  // 用逗号分隔多个变量
  Serial.print(sensorValue);
  Serial.print(",");
  Serial.println(sensorValue * 0.5);
  
  delay(50);
}

在 工具 → 串口绘图器 中可以看到实时波形图。

云同步​

登录 Arduino Cloud 账户后，可以在不同设备间同步项目文件：

  • 点击侧边栏的云图标登录
  • 创建云端项目
  • 自动同步本地和云端文件

IDE 2.x 安装​

  1. 访问 Arduino 软件下载页面
  2. 选择 IDE 2.x 版本下载
  3. 运行安装程序或解压便携版

IDE 2.x 快捷键​

快捷键功能
Ctrl+R验证/编译
Ctrl+U上传
Ctrl+Shift+M串口监视器
Ctrl+Shift+N新建项目
Ctrl+O打开项目
Ctrl+S保存
Ctrl+/注释/取消注释
Ctrl+T自动格式化
Ctrl+Space触发代码补全
F12跳转到定义

IDE 版本选择建议​

  • 初学者：推荐使用 IDE 2.x，界面现代，功能丰富
  • 教学环境：IDE 1.x 更稳定，兼容性更好
  • 专业开发：IDE 2.x 或 VS Code + PlatformIO

VS Code + PlatformIO（进阶选择）​

对于更专业的开发，推荐使用 VS Code + PlatformIO 扩展。

安装步骤​

  1. 安装 Visual Studio Code
  2. 打开 VS Code，进入扩展商店
  3. 搜索并安装 PlatformIO IDE 扩展
  4. 安装完成后，左侧会出现 PlatformIO 图标

创建项目​

  1. 点击 PlatformIO 图标 → Create New Project
  2. 输入项目名称
  3. 选择开发板（如 Arduino Uno）
  4. 选择框架（Arduino）
  5. 点击 Finish

PlatformIO 优势​

特性Arduino IDEPlatformIO
代码补全基础智能
语法检查无实时
库管理基础依赖自动管理
版本控制手动内置 Git
多平台需手动切换自动识别
单元测试不支持内置测试框架
项目模板无丰富模板

常用快捷键​

Arduino IDE​

快捷键功能
Ctrl+N新建项目
Ctrl+O打开项目
Ctrl+S保存
Ctrl+R验证/编译
Ctrl+U上传
Ctrl+Shift+M打开串口监视器
Ctrl+/注释/取消注释
Ctrl+T自动格式化代码

VS Code + PlatformIO​

快捷键功能
Ctrl+Shift+P命令面板
Ctrl+Shift+B编译
Ctrl+Shift+U上传
Ctrl+Shift+S串口监视器

下一步​

环境搭建完成！接下来我们将学习 Arduino 程序的基本结构和语法。