Arduino CLI 完全手册：从零开始的命令行开发之旅

Arduino CLI 是 Arduino 官方推出的强大命令行工具，让你能够完全摆脱图形界面的束缚，通过纯命令行方式完成 Arduino 项目的编译、上传、库管理和硬件配置。无论你是自动化脚本爱好者、CI/CD 实践者，还是追求极致效率的开发者，这份手册都将为你提供全面的安装和配置指导。

🚀 快速启动：三分钟上手

一键安装脚本（推荐新手）

这是最快捷的入门方式，特别适合想要立即体验 Arduino CLI 的用户：

curl -fsSL https://raw.githubusercontent.com/arduino/arduino-cli/master/install.sh | sh

💡 小贴士：安装脚本会自动检测你的系统架构，并下载对应的二进制文件到当前目录的 bin 子文件夹中。

包管理器安装（适合日常使用）

如果你已经习惯使用包管理器，这种方式能让你无缝集成到现有工作流中：

• macOS/Linux：brew install arduino-cli
• Windows：scoop install arduino-cli

📌 优势对比：

安装方式	适合人群	维护难度	更新便利性
安装脚本	新手用户	简单	手动更新
包管理器	有经验用户	自动	自动更新

🛠️ 专业定制：灵活部署方案

直接下载二进制文件

对于需要精确控制版本或离线安装的场景，直接下载预编译二进制文件是最佳选择。

版本选择指南：

• 稳定版：适合生产环境，功能稳定可靠
• 每日构建版：适合开发者，体验最新特性
• 历史版本：适合特定项目兼容性需求

从源码构建（开发者专属）

如果你想要贡献代码或需要深度定制，从源码构建提供了最大的灵活性：

1. 克隆仓库：git clone https://gitcode.com/gh_mirrors/ar/arduino-cli
2. 进入目录：cd arduino-cli
3. 构建项目：go build -o arduino-cli

💡 构建须知：确保你的 Go 版本在 1.16 或以上，以获得最佳兼容性。

🎯 实战配置：让工具真正为你所用

环境变量配置

安装完成后，最关键的一步是配置 PATH 环境变量：

# 将以下内容添加到 ~/.bashrc 或 ~/.zshrc
export PATH="$PATH:/path/to/arduino-cli/bin"

自动补全设置

启用 shell 自动补全能显著提升你的工作效率：

# Bash 用户
source <(arduino-cli completion bash)

# Zsh 用户  
source <(arduino-cli completion zsh)

📋 功能概览：你的命令行瑞士军刀

Arduino CLI 提供了丰富的命令集，涵盖 Arduino 开发的各个方面：

• arduino-cli board list：列出已连接的开发板
• arduino-cli compile：编译你的项目
• arduino-cli upload：上传程序到开发板
• arduino-cli lib install：安装依赖库
• arduino-cli sketch new：创建新项目

🔧 高级特性：探索更多可能

可插拔发现机制

Arduino CLI 采用先进的可插拔设备发现机制，能够自动识别和管理连接的硬件设备。

状态机说明：

• Alive → Idling：工具启动，等待设备连接
• Idling → Running：检测到开发板，开始监控
• Running → Syncing：设备状态同步
• 任何状态 → Dead：工具终止或异常退出

配置文件管理

通过 arduino-cli config 命令，你可以轻松管理工具配置：

• 查看配置：arduino-cli config dump
• 设置参数：arduino-cli config set logging.level debug

🎪 常见问题速查

问题1：安装后命令找不到？ → 检查 PATH 环境变量是否正确配置

问题2：如何更新到最新版本？ → 包管理器用户：brew upgrade arduino-cli → 脚本安装用户：重新运行安装脚本

问题3：兼容性如何保证？ → 建议使用与 Arduino IDE 相同版本的 CLI

💫 进阶技巧

集成到 CI/CD 流程

Arduino CLI 天然适合自动化构建流程，你可以在 GitHub Actions、GitLab CI 等平台中轻松集成：

# GitHub Actions 示例
- name: Install Arduino CLI
  run: curl -fsSL https://raw.githubusercontent.com/arduino/arduino-cli/master/install.sh | sh

批量操作脚本

利用 shell 脚本结合 Arduino CLI，实现批量项目编译和上传：

#!/bin/bash
for sketch in */; do
  arduino-cli compile --fqbn arduino:avr:uno "$sketch"
done

🏁 开始你的命令行之旅

现在你已经掌握了 Arduino CLI 的完整安装和配置方法。无论选择哪种安装方式，核心目标都是让这个强大的工具为你所用，提升开发效率。

记住：命令行的力量在于它的可重复性和自动化能力。开始使用 Arduino CLI，你会发现一个全新的、高效的 Arduino 开发世界正在等待着你！