解决新版esphome编译报错

silas3082

esphome更新最新版本之后，编译文件报错:

Error: uv installation via pip failed with exit code 1
Error: Failed to install Python dependencies into penv

这个问题通常出现在 ESPHome  2025.12 之后的版本中。由于新版本引入了 uv（一个极快的 Python 包管理器）来管理交叉编译所需的 Python 虚拟环境（penv），如果你的系统环境缺少某些依赖，或者之前的缓存文件损坏，就会导致安装 uv 或其依赖包时报错。

首先需要将你的环境切换到可以科学的环境中


找了很多方法，大多数是：
1. 清理编译缓存

有时候旧版本的残留文件会冲突。

• 在 ESPHome 面板中，点击报错设备旁边的 三个点 (⋮)。
• 选择 Clean Build Files（清理编译文件）。
• 重新点击 Install 或 Compile。
  
  

此方法不能解决我的问题，如果这个方法不行，就继续往下看第二个方法。

2. 配置 pip 国内镜像源

uv 在后台安装依赖时默认连接国外服务器，在飞牛 OS 环境下极易超时报错。你可以通过环境变量强制其使用阿里云或清华镜像。

• 进入飞牛 OS 的 Docker 管理器。
• 找到 ESPHome 容器，点击 编辑（需先停止容器）。
• 在 环境变量 (Environment) 中添加以下两条：
  
  
  • 变量名：PIP_INDEX_URL  值：https://mirrors.aliyun.com/pypi/simple/
  • 变量名：UV_INDEX_URL  值：https://mirrors.aliyun.com/pypi/simple/
    
    
• 保存并重启容器。
  
  

此方法解决了，可以正常编译了