Yarn 4 安装 Electron 时的网络超时问题解决方案

问题背景

在使用 Yarn 4 安装 Electron 时，开发者经常会遇到网络超时问题，表现为安装过程中出现 ETIMEDOUT 错误。这是由于 Electron 的安装过程需要从 GitHub 下载二进制文件，而国内网络环境访问 GitHub 经常不稳定。

错误现象

典型的错误日志显示为：

RequestError: connect ETIMEDOUT 20.205.243.166:443

这表明 Yarn 在尝试连接 GitHub 服务器时发生了超时。

传统解决方案

在使用 npm 时，开发者可以通过在 .npmrc 文件中配置镜像源来解决这个问题：

ELECTRON_MIRROR="https://npmmirror.com/mirrors/electron/"

然而，Yarn 4 不再自动读取 .npmrc 中的配置，导致这一方法失效。

Yarn 4 下的解决方案

方法一：使用环境变量

Electron 官方支持通过环境变量配置镜像源。在 Yarn 4 中，可以通过以下方式设置：

1. 创建 .env.yarn 文件
2. 添加以下内容：

ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/

方法二：直接设置环境变量

在运行 Yarn 命令前，直接在终端中设置环境变量：

export ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/
yarn

对于 Windows 用户，可以使用：

set ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/
yarn

技术原理

Electron 的安装过程分为两个阶段：

1. 下载 package.json 中指定的 Electron 版本元数据
2. 根据平台下载对应的预编译二进制文件

正是第二阶段需要从 GitHub 下载大文件，容易导致超时。通过设置 ELECTRON_MIRROR 环境变量，我们可以将下载源切换到国内镜像，显著提高下载成功率。

最佳实践建议

1. 对于团队项目，建议将 .env.yarn 文件加入版本控制，确保所有开发者使用相同的镜像源
2. 可以同时配置多个备用镜像源，提高可靠性
3. 对于 CI/CD 环境，确保在构建脚本中正确设置了环境变量

总结

Yarn 4 虽然不再支持从 .npmrc 读取配置，但通过环境变量仍然可以灵活地配置 Electron 的安装源。理解这一机制后，开发者可以轻松解决网络超时问题，享受 Yarn 4 带来的其他优势。