从日志中可以非常明确地看到问题所在：
```
WARNING: Download failure: [Errno 28] No space left on device
```
核心问题：你的 C: 盘（系统盘）空间不足了。**
ESP-IDF 的工具链（尤其是编译器）非常庞大。仅 `riscv32-esp-elf` 这个文件就有 677MB，而你的 C 盘在下载了约 210MB 后就没有空间了，导致下载失败。
解决方案
你需要清理 C 盘空间，或者更改 ESP-IDF 工具的安装路径到一个有足够空间的其他磁盘（如 D: 盘）。
方案一：清理 C 盘空间（临时解决）
这是最直接的解决办法，但可能只是权宜之计。
1. 打开“设置” > “系统” > “存储”**。
2. 点击 “临时文件”，系统会计算可以清理的文件。
3. 勾选所有你想删除的临时文件类型（通常包括“下载”文件夹、“临时文件”、“回收站”等），然后点击 “删除文件”。
4. 此外，你还可以检查并卸载一些不常用的软件，或者将大文件（如视频、游戏）转移到其他磁盘。
清理出至少 1-2 GB 的空闲空间后，**删除 `C:\Users\Administrator\.espressif\dist` 目录**（这个目录里是下载失败的不完整文件），然后重新运行 `.\install.ps1` 脚本。
方案二：更改 ESP-IDF 工具安装目录（推荐，一劳永逸）
如果你 C 盘空间长期紧张，强烈建议将 ESP-IDF 的庞大工具链安装到其他空间充足的磁盘（比如你的 D: 盘）。
操作步骤：
1. 删除旧的不完整目录：
为了避免冲突，首先删除 `C:\Users\Administrator\.espressif` 这个目录。
2. 设置环境变量 `IDF_TOOLS_PATH`：
这个环境变量会告诉 ESP-IDF 安装脚本将所有工具下载并安装到你指定的位置。
* 在 PowerShell 中执行以下命令，将工具路径设置到 D 盘的 `esp-idf-tools` 目录（你可以自定义这个路径）：
```powershell
[Environment]::SetEnvironmentVariable("IDF_TOOLS_PATH", "D:\esp-idf-tools", "User")
```
* 注意：** 这个命令只在当前 PowerShell 会话中临时生效，方便我们接下来的操作。如果你想永久生效，可以通过“此电脑” -> “属性” -> “高级系统设置” -> “环境变量”来添加。
3. 重新运行安装脚本：
在**同一个 PowerShell 窗口**中，再次运行安装脚本：
```powershell
.\install.ps1
```
此时，安装脚本会检查到 `IDF_TOOLS_PATH` 环境变量，并将所有工具（包括 Python 虚拟环境、编译器等）都下载和安装到 `D:\esp-idf-tools` 目录下，从而避免占用 C 盘空间。
4. （重要）配置 `export.ps1` 脚本：
以后每次你需要手动运行 `export.ps1` 来配置环境时，都需要先设置 `IDF_TOOLS_PATH` 环境变量，否则它会找不到工具。
最简单的方法是创建一个批处理文件（`.bat`）来自动完成这个过程：
在你的项目目录（`D:\xiaozhi-esp32`）或者 ESP-IDF 目录下，创建一个名为 `setup-env.bat` 的文件。
用记事本打开这个文件，写入以下内容：
```batch
@echo off
:: 设置工具路径
set "IDF_TOOLS_PATH=D:\esp-idf-tools"
:: 调用 export.ps1 脚本
powershell -NoExit -Command "& { . 'D:\Espressif\esp-idf\frameworks\esp-idf-v5.4.2\export.ps1' }"
```
保存文件。
以后，你只需要双击运行这个 `setup-env.bat`，它就会自动打开一个配置好所有环境的 PowerShell 窗口，非常方便。
总结与建议
根本原因：C 盘空间不足，无法完成工具链的下载。
快速解决：清理 C 盘空间，删除 `C:\Users\Administrator\.espressif\dist`，然后重试安装。
最佳方案：采用 方案二，通过设置 `IDF_TOOLS_PATH` 环境变量，将 ESP-IDF 的所有工具都安装到空间更大的 D 盘。这能从根本上解决 C 盘空间不足的问题，并让你的开发环境更加整洁。
我要赚赏金打赏帖
STM32
MCU
通讯及无线技术
物联网技术
电子DIY
板卡试用
基础知识
软件与操作系统
我爱生活
小e食堂
