彻底分析Arduino库安装和开发板库安装路径和方式

article/2025/9/22 19:48:57

参考：https://blog.csdn.net/weixin_43794311/article/details/128631564，https://blog.csdn.net/t01051/article/details/103766886

一个最简单的安装esp8266和esp32的方法

在网址：https://arduino.me/download，下载对应的开发板库的exe文件，双击exe就可快速安装。而使用Arduino安装困难的主要问题就是自动安装的库是从GitHub上下载的。

管理库和开发板管理库文件最终位置

开发板的管理库文件安装位置

zip文件在路径C:\Users\Administrator\AppData\Local\Arduino15\staging\packages，（库zip文件和支持文件的zip，下载见下面内容）最终安装到了路径C:\Users\Administrator\AppData\Local\Arduino15\packages
在这里插入图片描述

开发板库的安装位置和自动下载位置

直接使用IDE下载zip文件个人没成功过，但从GitHub下载zip文件后通过IDE安装成功，自动把zip文件保存的位置C:\Users\Administrator\AppData\Local\Arduino15\staging\packages，开发板管理器安装的库最终是安装在了这里C:\Users\Administrator\AppData\Local\Arduino15\packages文件夹内，注意这两个文件夹位置只是差一个层级。

开发板库zip文件和安装好的文件进行比较

下图中绿色字体有一处错误，pyhon的下级文件名字是3.7.2-post1，然后就是和支持包内部文件一样
在这里插入图片描述

安装库的位置

管理库是安装在个人设置的项目路径\libraries（通过Arduino的IDE中“文件”-“首选项”查看，如下图），下载zip到路径C:\Users\Administrator\AppData\Local\Arduino15\staging\packages下，则对应路径如下图
在这里插入图片描述

离线安装的多个准备知识

开发板管理器地址

用于搜索库的json文件，可以通过IDE找到自己需要的地址。如下图，整体按照蓝色箭头顺序。
在这里插入图片描述

管理器存放地址和里面内容分析

上述设置好后，重启一下，IDE会自动下载join文件到C:\Users\Administrator\AppData\Local\Arduino15下，下面以https://arduino.esp8266.com/stable/package_esp8266com_index.json，实际在文件夹内的名字是package_esp8266com_index.json内容整体主要如下，
在这里插入图片描述
查看目前最新的版本和解释：

zip包的下载

核心esp8266包的下载

在这里插入图片描述

支持包安装

在上步骤的esp8266的zip下载完成后，修改名字和json文件中同样的zip名字，就是"archiveFileName"后面的字符（这里是esp8266-3.1.1.zip），让后放入C:\Users\Administrator\AppData\Local\Arduino15\staging\packages，文件夹下。这时再回到IDE直接点击安装（一定和zip一个版本），
在这里插入图片描述
由于安装位置没有支持包，IDE会在GitHub下载支持zip包，，当下载失败后可能会显示下载失败的url，四个支持包的位置：https://github.com/earlephilhower/esp-quick-toolchain/releases/tag/3.1.0-gcc10.3

在这里插入图片描述

zip包全部下载完成后，可以安装

把所有zip的文件都放在C:\Users\Administrator\AppData\Local\Arduino15\staging\packages，文件夹下。这时再回到IDE直接点击安装（一定和zip一个版本），这样就能安装完成。

有一种方式很快，但有些问题

直接把核心的esp8266-3.1.1.zip解压后，把文件直接放在C:\Users\Administrator\AppData\Local\Arduino15\packages内，但显示会不同，可能也会出现其他问题，而且IDE并没有检测到esp8266中的NodeMCU…
在这里插入图片描述

一个尝试

把esp8266-3.1.1.zip直接解压后，将最终的14个文件放在C:\Users\Administrator\AppData\Local\Arduino15\packages\esp8266\hardware\esp8266\3.1.1只需要在原有路径C:\Users\Administrator\AppData\Local\Arduino15\package增加几个层级文件夹sesp8266\hardware\esp8266\3.1.1,然后把14个文件放进去。这时重启IDE后发现，IDE 识别这个库安装好了。
在这里插入图片描述
但是在编译和上传文件时出现问题。