David 的小窝

Arduino 安装 ESP32 开发工具链指南

2026-01-01 · 3 min read

Arduino 安装 ESP32 开发工具链指南

本指南适用于在安装 ESP32 开发工具链时因无法高速稳定连接至 Github 而安装失败的情况。

前置准备

安装 Arduino CLI

Arduino CLI 是一款一体化解决方案,提供板子/库管理器、草图构建器、板子检测、上传器以及许多其他工具,用于通过命令行或机器接口使用任何兼容 Arduino 的板子和平台。
除了作为独立工具外,Arduino CLI 还是所有官方 Arduino 开发软件(Arduino IDE、Arduino 网页编辑器)的核心。本文档部分内容同样适用于这些工具。

(摘自 Arduino 官网关于 Arduino CLI 的文档)

如果已经安装 Arduino IDE,可以在 Arduino IDE\resources\app\lib\backend\resources\ 目录下找到 Arduino CLI 本体(arduino-cli.exe),使用方法与作为独立工具相同。

可稳定从 Github 下载的方式

可以是镜像源(加速下载)或者加速工具,在 Arduino IDE 或 Arduino CLI 中直连无法获得好的下载体验并不代表无法使用这些下载方式。

镜像源(加速下载)如 GitHub 文件加速代理GitHub 文件加速;加速工具如 FastGithub(或 Gitee 镜像)、Watt ToolkitGitHub520(或 Gitee 镜像)。

可使用多线程下载工具(如 Neat Download Manager)加速下载。

安装流程

在命令行中运行 Arduino CLI,依次执行以下命令:

arduino-cli config init
arduino-cli core update-index

以初始化配置文件并更新核心索引(在 PowerShell 中须在 arduino-cli 前添加 ./,或使用绝对路径)。

(*)接下来执行:

arduino-cli core install esp32:esp32

以安装 ESP32 核心(即 ESP32 开发工具链)。

此时视网络情况,可能可以成功下载一些较小的包(如果能与 Github 建立连接),但是遇到较大的包时通常会连接超时或下载超时,此时我们就需要手动下载这些包并放置到 Arduino 的下载缓存文件夹下。

当 Arduino CLI 下载失败报错时,阅读错误信息。如果错误信息中包含包的链接,那么直接通过别的途径下载即可;如果仅包含包名,则可以通过文本编辑器打开 Arduino 目录(通常为 C:\Users\<UserName>\AppData\Local\Arduino15\)下的 package_index.json 文件,在其中使用查找功能等找到包名(archiveFileName 键对应的值)及其对应的的包链接(url 键对应的值),然后从该链接通过别的途径下载对应的包。

包下载完毕后,将其放置在与 Arduino CLI 一致的缓存目录(通常为 C:\Users\<UserName>\AppData\Local\Arduino15\staging\packages\)下,接下来回到(*)步骤,重复这个过程直到所有包都下载完毕。不用担心包可能损坏或对应错误,Arduino CLI 会通过 SHA-256 和包大小进行校验。

所有包都下载完成后,再次回到(*)步骤,此时 Arduino CLI 在检查所有包都已下载完毕后会依次安装每个包,当看到 Platform esp:esp32@A.B.C installed(ESP32 平台安装完毕)时,恭喜你成功安装了开发 ESP32 所需的工具链!