当前位置: 首页 > news >正文

平台安装失败:‘esp32:2.0.10‘ 13 INTERNAL: Download failed: performing HEAD request: Head “https://github.co

方案一:使用国内镜像源安装(最推荐)

直接给 Arduino IDE 换上由乐鑫官方维护的国内镜像,从根本上解决网络问题。

  1. 打开设置:在 Arduino IDE 中,点击文件 (File) > 首选项 (Preferences)

  2. 替换镜像源:在“附加开发板管理器网址”一栏,粘贴以下任一链接(推荐使用稳定版),然后点击“好”保存。

    • 稳定版 (Stable) 链接https://jihulab.com/esp-mirror/espressif/arduino-esp32/-/raw/gh-pages/package_esp32_index_cn.json

    • 开发版 (Development) 链接https://jihulab.com/esp-mirror/espressif/arduino-esp32/-/raw/gh-pages/package_esp32_dev_index_cn.json

  3. 重新安装:进入工具 (Tools) > 开发板 (Board) > 开发板管理器 (Boards Manager),搜索ESP32,找到由Espressif Systems发布的板级支持包,选择带有-cn后缀的版本进行安装

请注意:带有-cn后缀的版本与不带后缀的标准版本在功能上完全一样,只是下载源不同。乐鑫官方也会持续维护,可以放心使用。

🛠️ 方案二:手动离线安装(网络较差时选这个)

如果方案一还是失败,可以手动下载并放置所有必需的文件,这是最稳妥的方式。

第1步:找到正确的安装路径

首先,需要找到 Arduino IDE 存放板级支持包的位置。通常情况下,它在这里:

  • Windows:C:\Users\{你的用户名}\AppData\Local\Arduino15\packages

  • macOS:~/Library/Arduino15/packages

  • Linux:~/.arduino15/packages

AppDataLibrary文件夹通常是隐藏的,你需要在文件管理器中开启“显示隐藏的项目”才能看到。

第2步:手动下载并放置文件

有两种方式可以获取到所需的离线包。

  • 方式 A:使用他人整理的离线包(最便捷)
    直接搜索“ESP32 Arduino 离线安装包”,例如你可以从CSDN的博主分享中找到百度网盘链接,下载一个包含所有文件的完整压缩包,解压后放入第1步中找到的packages文件夹即可。

  • 方式 B:手动补齐缺失文件(更可控)

    1. 先按照方案一,让 IDE 开始在线安装。

    2. 当安装过程卡住并提示Downloading packages时,记录下它正在下载的文件名(例如openocd-esp32-win32-0.11.0-esp32-20221026.zip)。

    3. 在浏览器中打开 GitHub 的 Releases 页面 https://github.com/espressif/arduino-esp32/releases,找到与你安装版本对应的压缩包进行下载。

    4. 将下载好的压缩包(不要解压)复制到 Arduino 的临时文件夹%USERPROFILE%\.arduino15\staging\packages中。

    5. 重新启动 Arduino IDE,再次尝试安装。此时 IDE 会发现文件已存在,跳过下载直接进入解压步骤。

⚙️ 方案三:配置网络代理(如果你有代理)

如果你有代理工具,可以为 Arduino IDE 单独配置,避免它不继承系统代理的问题。

  1. 获取代理信息:打开 Windows设置 > 网络和 Internet > 代理,查看“手动设置代理”下的地址和端口(例如127.0.0.17890)。

  2. 配置 IDE:在 Arduino IDE 的文件 (File) > 首选项 (Preferences)中,切换到网络 (Network)设置,将代理方式改为手动 (Manual),并填入你的代理地址和端口。保存后重启 IDE。

💡 方案四:使用社区工具(省心省力)

一些热心开发者制作了一键安装工具,能自动完成国内镜像配置和安装。例如,你可以在飞书文档中找到 Arduino ESP32 Board Manager 一键安装&更新工具。按工具的提示操作即可,它也会自动处理网络问题。

🚨 方案五:备选方案与其他建议

如果以上方法都无效,还可以试试下面的策略:

  • 更换 ESP32 核心版本:可以尝试安装2.0.17或更新的3.0.x稳定版(但避免使用已知有问题的3.0.6版本)。

  • 清理残留文件:有时旧文件会干扰新安装,可以手动删除以下文件夹后再试:

    • %USERPROFILE%\.arduino15\packages\esp32

    • %USERPROFILE%\.arduino15\staging\packages里的所有文件。

  • 更换 Arduino IDE 版本:部分用户反馈,降级到 Arduino IDE 1.8.19 版本后安装成功了。但这属于备选方案,建议优先尝试其他方法。

  • 延长网络超时时间:你也可以尝试修改 Arduino CLI 的配置文件,延长网络超时时间。在C:\Users\<你的用户名>\.arduinoIDE\arduino-cli.yaml文件末尾添加以下内容:

    yaml

    network: connection_timeout: 600s
http://www.jsqmd.com/news/608589/

相关文章:

  • 从“数据孤岛”到“统一视图”:一套可落地的主数据管理规划方法论
  • 如何用Python+Neo4j构建医疗知识图谱?从数据清洗到因果推断实战
  • PHP 8.9协程I/O瓶颈在哪?5个被90%开发者忽略的Swoole+Fiber调优盲区
  • 4步精通League Director:从零基础到专业级英雄联盟录像编辑解决方案
  • 别再只会用OpenAI库了!用Requests库手把手教你调用硅基流动大模型API(附完整错误处理)
  • Submariner 故障排除手册:常见网络连接问题的解决方案
  • 2026年国内口碑好的立绕机源头厂家哪家好,下线机/嵌线机/插纸机/三头六工位立绕机/伺服插纸机,立绕机供应商推荐 - 品牌推荐师
  • 数字遗产继承:科技向善与法律完善的双重挑战
  • MATLAB伯德图进阶:精准标注谐振点与-3dB带宽的实现方法
  • Span<T> + Unsafe + MemoryPool = 超低延迟服务基石,3个高频场景重构实录(含完整可运行代码)
  • Nuxt3数据请求性能优化:如何用lazy和server选项提升页面加载速度
  • 小白友好指南:在星图GPU平台无代码体验OpenClaw+Qwen3-32B
  • 自动驾驶仿真新手必看:OpenSCENARIO 1.0标准场景搭建实战(附51Sim-One配置指南)
  • 别再手动调参了!用Python+PyTorch实战DnCNN,5步搞定地震数据智能去噪
  • 上海泛惠科技客服咨询AI流量赋能,重塑智能体验新标杆 - 速递信息
  • 比迪丽LoRA部署教程:WSL2+Windows本地GPU环境全适配方案
  • C# 13主构造函数深度解析(.NET 8.0.3实测对比报告):构造开销降低67%,但92%开发者仍在写错
  • 赋能智造升级——电子水泵/油泵自动化装配线供应商推荐及行业深度解析 - 品牌评测官
  • WPF新手村教程(七)—— 终章(MVVM架构初见杀)募
  • Vue项目实战:高德地图遮罩层踩坑实录(附完整代码)
  • 从安防到自动驾驶:红外-可见光融合技术落地避坑指南
  • 浅谈AI与Skill——从Claude Code看AI工具如何重塑技能价值
  • Lattice Planner算法在自动驾驶中的轨迹规划实战
  • 基于CURSOR的APP自动化测试框架实战指南(一)
  • 维护遗留代码的工程师,才是真正的勇士
  • 【OPC UA安全配置生死线】:C#工业通信必须启用的3层加密+2项证书策略(附权威IEC 62541合规对照表)
  • [Linux][虚拟串口]x一个特殊的字节芭
  • 工业视觉实战:用Steger算法提取激光条纹中心,完整流程与OpenCV参数调优避坑指南
  • 2026年三维扫描仪公司怎么选?启源视觉给出计量级答案 - 工业三维扫描仪评测
  • AutoGLM-Phone-9B功能体验:实测语音指令控制与图像识别