环境搭建

本章将指导你完成 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

让我们上传经典的 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

解决方法：

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

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 IDE	PlatformIO
代码补全	基础	智能
语法检查	无	实时
库管理	基础	依赖自动管理
版本控制	手动	内置 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 程序的基本结构和语法。