Arduino CLI 安装指南：从入门到精通

前言

Arduino CLI 是 Arduino 官方提供的命令行工具，它允许开发者在不使用图形界面的情况下完成 Arduino 项目的编译、上传和管理。本文将详细介绍 Arduino CLI 的多种安装方式，帮助开发者选择最适合自己的安装方法。

安装方式概览

Arduino CLI 提供了多种安装方式，主要包括：

1. 通过包管理器安装（Homebrew）
2. 使用安装脚本
3. 直接下载预编译二进制文件
4. 从源代码构建

1. 通过 Homebrew 安装（macOS/Linux）

对于 macOS 和 Linux 用户，使用 Homebrew 是最简单的安装方式。

安装步骤

brew update
brew install arduino-cli

特点

• 自动安装最新稳定版本
• 包含命令行补全功能
• 便于后续更新管理

适用场景

• 已经使用 Homebrew 管理软件包的用户
• 希望简化安装和更新流程的用户

2. 使用安装脚本

安装脚本提供了一种快速安装方式，适用于大多数 Unix-like 系统。

基本安装命令

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

自定义安装目录

curl -fsSL https://raw.githubusercontent.com/arduino/arduino-cli/master/install.sh | BINDIR=~/local/bin sh

安装特定版本

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

注意事项

• 脚本会将 Arduino CLI 安装到当前目录的 bin 子目录下
• 如需全局使用，需要将安装目录添加到 PATH 环境变量中
• 默认会检查更新，可通过配置禁用

3. 直接下载预编译二进制文件

对于需要更多控制权的用户，可以直接下载预编译的二进制文件。

下载选项

Arduino CLI 为不同平台提供了多种构建版本：

最新稳定版

• Linux: 32位/64位/ARM/ARMv6
• Windows: 32位/64位(EXE/MSI)
• macOS: Intel/Apple Silicon

历史版本

可以获取过去的特定版本

每日构建版(Nightly Builds)

• 每日自动构建的最新开发版本
• 可能包含未经验证的新功能
• 适合希望体验最新特性的开发者

使用建议

1. 根据系统架构选择合适的版本
2. 解压下载的文件
3. 将可执行文件所在目录添加到 PATH 环境变量

4. 从源代码构建

对于 Go 开发者或希望贡献代码的用户，可以从源代码构建。

构建要求

• Go 1.16 或更高版本
• 基本的 Go 开发环境

构建步骤

1. 获取源代码
2. 运行构建命令
3. 生成可执行文件

优势

• 可以自定义构建选项
• 便于调试和开发
• 可以获取最新的开发特性

安装后的配置

无论采用哪种安装方式，建议进行以下配置：

1. PATH 环境变量：确保可以全局访问 arduino-cli 命令
2. 自动补全：配置 shell 自动补全提高效率
3. 更新设置：根据需求配置自动更新检查

版本选择建议

• 生产环境：使用最新稳定版
• 开发测试：可以考虑每日构建版
• 定制需求：从源代码构建

常见问题

1. 权限问题：在 Linux/macOS 上可能需要 sudo 权限
2. PATH 配置：安装后命令不可用通常是 PATH 未正确配置
3. 版本兼容性：注意 Arduino CLI 与 IDE 版本的兼容性

总结

Arduino CLI 提供了灵活的安装方式，开发者可以根据自己的技术水平和需求选择合适的安装方法。对于大多数用户，推荐使用包管理器或安装脚本进行安装；高级用户则可以考虑直接下载二进制文件或从源代码构建。正确安装后，Arduino CLI 将成为 Arduino 开发中的强大工具，特别适合自动化构建和持续集成场景。