Arduino IDE 离线安装ESP8266教程
如果你正对着 Arduino IDE 的下载进度条发呆，或者身处一个没有网络（或者网络极其“傲娇”）的环境，那么这篇离线安装指南就是你的救星。
其实，所谓的“离线安装”，本质上就是手动把开发板所需的包文件下载好，并放到 Arduino IDE 能找到的指定目录中。
准备工作
在开始之前，你需要准备好以下资源（建议在有网的地方提前下好，或者用 U 盘拷贝）：
-
Arduino IDE：确保已经安装好主程序。
-
ESP8266 离线包：通常是一个
.zip或.tar.gz压缩包。 -
JSON 索引文件：
package_esp8266com_index.json。
方法一：利用 staging 目录（推荐）
提供的离线文件版本为ESP8266 3.1.2！！！！！ 通过网盘分享的文件：esp8266 链接: https://pan.baidu.com/s/1xGC2yQMX48ibwRGNEeO7Ag?pwd=48rd 提取码: 48rd
这是最稳妥的方法，因为它保留了 Arduino IDE 的自动管理机制。
1. 定位数据文件夹
Arduino IDE 的下载缓存存放在一个特定的隐藏文件夹中：
-
Windows:
%LocalAppData%\Arduino15(在运行中输入即可跳转) -
macOS:
~/Library/Arduino15 -
Linux:
~/.arduino15
2. 放置索引文件
将 package_esp8266com_index.json 直接拷贝到上述 Arduino15 根目录下。
3. 放置安装包
在 Arduino15 文件夹内找一个叫 staging/packages 的文件夹（如果没有就手动建一个）。将下载好的 ESP8266 压缩包原封不动地丢进去。
4. 伪装“在线”安装
-
打开 Arduino IDE，点击 文件 -> 首选项。
-
在“附加开发板管理器地址”中填入：
http://arduino.esp8266.com/stable/package_esp8266com_index.json（虽然是离线，但 IDE 需要这个地址来匹配本地文件）。 -
点击 工具 -> 开发板 -> 开发板管理器。
-
搜索
esp8266，你会发现版本已经出现了。点击 安装。 -
见证奇迹： IDE 会检测到
staging/packages里已经有对应的包，于是它不会去联网下载，而是直接解压安装。
方法二：手动解压到 hardware 目录（进阶版）
如果你连 JSON 文件都懒得折腾，可以直接把源码塞进 IDE 的硬件目录。
-
找到你的 Arduino 项目文件夹（通常在
文档/Arduino）。 -
在里面新建一个文件夹名为
hardware。 -
在
hardware下新建一个文件夹名为esp8266com，再往下一层建一个esp8266。 -
将 ESP8266 的源码内容解压到这个
esp8266文件夹中。路径看起来应该是这样：
Arduino/hardware/esp8266com/esp8266/cores/... -
关键一步： 进入
esp8266/tools目录，运行get.py（需要安装 Python）。它会自动下载缺失的工具链。- 注：如果这步也想离线，你需要手动下载 xtensa 工具链并解压到 tools 目录下。
常见路径对照表
| 操作系统 | 默认数据路径 (Arduino15) |
|---|---|
| Windows | C:\Users\用户名\AppData\Local\Arduino15 |
| macOS | /Users/用户名/Library/Arduino15 |
| Linux | /home/用户名/.arduino15 |
避坑指南
[!IMPORTANT]
版本匹配： 如果你下载的 JSON 文件里记录的是 3.1.2 版本，但你丢进 staging 的压缩包是 3.0.2 版本，IDE 还是会尝试联网下载 3.1.2。请务必确保压缩包版本与 JSON 描述一致。
[!TIP]
工具链缺失： 有时候开发板装好了，编译却报错找不到
xtensa-lx106-elf-gcc。这通常是因为staging目录下缺少对应的工具链压缩包。别忘了把配套的 tools 包也放进去。