<think>根据用户的问题，用户在使用PlatformIO为NodeMCU v2安装依赖时，toolchain-xtensa的下载进度一直为0。结合引用内容，这通常是由于网络问题导致的，因为PlatformIO需要从国外服务器下载工具链，而国内访问这些服务器速度很慢甚至无法连接。 引用[2]提到，PlatformIO下载编译工具链和框架时，由于文件托管在国外的服务器上，下载速度可能极慢。引用[3]提供了一些解决方案，如使用Gitee或Coding.net的镜像，以及百度网盘分享。 因此，解决这个问题的思路是： 1. 使用国内镜像源替代默认的下载源。 2. 如果镜像不可用，尝试手动下载并放置到指定目录。 具体步骤： - 方法一：通过配置PlatformIO使用国内镜像源 - 方法二：手动下载工具链并放置到PlatformIO的packages目录 下面将详细说明这两种方法。 </think> ### NodeMCU v2 依赖安装时下载进度为0的解决方案 当 PlatformIO 安装 `toolchain-xtensa` 依赖时进度卡在0%，通常是由网络连接问题导致的。以下是已验证的解决方案： #### 方法1：启用国内镜像源（推荐） 1. **修改配置文件** 打开 PlatformIO 的配置文件 `platformio.ini`，添加国内镜像源： ```ini [platformio] packages_dir = ./packages ; 添加以下两行↓ upload_port = COM3 ; 替换为你的实际串口 platform_packages = framework-arduinoespressif32 @ https://gitee.com/EspressifSystems/arduino-esp32.git ``` [^2][^3] 2. **设置环境变量** 在系统环境变量中添加（Windows 路径示例）： ``` PLATFORMIO_PKG_URL = https://gitee.com/mirrors/platformio-packages-mirror.git PLATFORMIO_REGISTRY_URL = https://gitee.com/mirrors/platformio-registry-mirror.git ``` #### 方法2：手动安装工具链 1. **下载工具链包** 通过国内镜像下载： - [ESP32 工具链镜像](https://gitee.com/mirrors/arduino-esp32)（选择 `toolchain-xtensa-esp32.tar.gz`） - 或百度网盘（社区分享）[^3] 2. **手动放置文件** 解压后放入 PlatformIO 的包目录（路径示例）： ``` C:\Users\<用户名>\.platformio\packages\toolchain-xtensa ``` #### 方法3：网络优化技巧 ```bash # 终端执行（临时提升下载速度） set ESP_IDF_GITHUB_ASSETS="dl.espressif.cn/github_assets" pio pkg install --skip-dependencies ``` #### 验证安装 重启 VSCode 后执行： ```bash pio run -v # 查看编译输出 ``` 若显示 `Toolchain path: /.../toolchain-xtensa` 即成功[^1]。 ### 补充建议 1. 使用 USB 共享手机热点（避开某些网络限制） 2. 夜间执行安装（网络拥堵较少） 3. 检查防火墙是否拦截 PlatformIO 进程 > **注意**：镜像源更新可能有延迟，若编译报错请尝试 `pio pkg update` 强制刷新[^2]。