Arduino CLI 完全手册：从零开始的命令行开发之旅-平芜编程栈

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

【免费下载链接】arduino-cliArduino command line tool项目地址: https://gitcode.com/gh_mirrors/ar/arduino-cli

🚀 快速启动：三分钟上手

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

这是最快捷的入门方式，特别适合想要立即体验 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

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

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

直接下载二进制文件

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

版本选择指南：

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

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

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

克隆仓库：git clone https://gitcode.com/gh_mirrors/ar/arduino-cli
进入目录：cd arduino-cli
构建项目：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 开发世界正在等待着你！