你想让 npm install --save-dev electron electron-builder
用国内镜像源下载，还希望配置后每次下载都自动使用国内源，
我分「临时使用」「永久配置」「针对性优化（electron专属）」
三部分给你完整方案，确保下载速度大幅提升：

一、临时使用国内源（单次生效，适合临时下载）

直接在安装命令中指定淘宝镜像，无需修改全局配置，执行以下命令即可：

# 方式1：安装时临时指定npm镜像（推荐）
npm install --save-dev electron electron-builder --registry=https://registry.npmmirror.com

# 方式2：同时指定electron专属镜像（解决electron二进制包下载慢）
npm install --save-dev electron electron-builder --registry=https://registry.npmmirror.com --electron_mirror=https://npmmirror.com/mirrors/electron/

二、永久配置国内镜像（全局生效，一劳永逸）

配置后，所有npm命令都会自动使用国内源，无需每次手动加参数，分2步操作：

步骤1：配置npm全局镜像（核心）

打开命令行（CMD/PowerShell/终端），执行以下命令（复制粘贴即可）：

# 1. 设置npm默认镜像为淘宝源（npmmirror是淘宝镜像新域名）
npm config set registry https://registry.npmmirror.com

# 2. 配置electron二进制包镜像（解决electron下载慢/失败）
npm config set electron_mirror https://npmmirror.com/mirrors/electron/

# 3. 配置electron-builder依赖的镜像（可选，进一步提速）
npm config set electron-builder-binaries_mirror https://npmmirror.com/mirrors/electron-builder-binaries/

# 4. 验证配置是否生效（执行后会显示配置的镜像地址）
npm config get registry
npm config get electron_mirror

步骤2：（可选）通过配置文件手动修改（防止命令执行失败）

如果上述命令执行报错，可直接修改npm的配置文件：

1. 打开npm配置文件：
   • Windows：在文件管理器中打开 C:\Users\你的用户名\.npmrc（没有就新建一个）；
   • Mac/Linux：终端执行 vim ~/.npmrc。
2. 粘贴以下内容并保存：

   registry=https://registry.npmmirror.com
   electron_mirror=https://npmmirror.com/mirrors/electron/
   electron-builder-binaries_mirror=https://npmmirror.com/mirrors/electron-builder-binaries/
   disturl=https://npmmirror.com/mirrors/node/
   chromedriver_cdnurl=https://npmmirror.com/mirrors/chromedriver/
   operadriver_cdnurl=https://npmmirror.com/mirrors/operadriver/
   phantomjs_cdnurl=https://npmmirror.com/mirrors/phantomjs/
   sass_binary_site=https://npmmirror.com/mirrors/node-sass/
   python_mirror=https://npmmirror.com/mirrors/python/

   这些额外配置能覆盖大部分npm包的国内镜像，不仅electron，其他包下载也会提速。

三、配置完成后，正常执行安装命令即可

配置好全局镜像后，直接执行原命令，会自动走国内源：

npm install --save-dev electron electron-builder

四、补充说明（避坑关键）

1. 镜像地址说明：

   • 淘宝npm镜像原域名 registry.npm.taobao.org 已停用，现在用 registry.npmmirror.com（一定要用新域名）；
   • electron的二进制包（如exe/dmg）不在npm镜像里，需单独配置 electron_mirror，否则仍会下载缓慢。

2. 重置镜像（如需恢复默认）：
   如果后续想切回官方源，执行：

   npm config delete registry
   npm config delete electron_mirror

3. 解决electron-builder下载依赖失败：
   若安装electron-builder时仍报错，可手动设置环境变量（Windows为例）：

   • 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」；
   • 「系统变量」→「新建」，添加：
     • 变量名：ELECTRON_BUILDER_BINARIES_MIRROR
     • 变量值：https://npmmirror.com/mirrors/electron-builder-binaries/
   • 重启命令行，重新执行安装命令。

总结

1. 临时使用：安装命令后加 --registry=https://registry.npmmirror.com --electron_mirror=https://npmmirror.com/mirrors/electron/；
2. 永久生效：执行 npm config set 配置镜像，或手动修改 .npmrc 文件；
3. 关键优化：electron需单独配置二进制包镜像，否则仅npm源生效仍会慢。

配置完成后，后续所有 npm install 命令都会自动使用国内源，包括安装其他包，无需重复配置。

✅ 完整版：npm 配置【永久国内镜像源】+ 环境变量全局生效 + electron/electron-builder 极速下载（整理排序、步骤清晰、永久生效）

核心需求：解决npm install --save-dev electron electron-builder下载慢/超时/失败问题，配置后所有npm下载、所有依赖包、所有项目，永久自动走国内镜像，无需每次手动加参数，一劳永逸，Windows系统完整适配

✔️ 前置说明（必看）

1. electron 是特殊包：它的核心二进制安装包 不在npm默认仓库里，只配置npm镜像没用，必须单独配置 electron 专属镜像 + electron-builder 专属镜像
2. 淘宝镜像已更换官方新域名：原registry.npm.taobao.org已废弃，新版国内官方镜像地址为 npmmirror.com，所有配置全部用新地址，杜绝失效
3. 本次配置分为「两步核心方案」：
   • 方案一：npm 全局镜像配置（永久生效，所有npm命令自动适配）
   • 方案二：系统环境变量配置（永久生效，优先级最高，解决electron/electron-builder顽固的下载失败问题）
   • 两个方案全部配置后，彻底根治所有npm包+electron全家桶的下载问题，以后不管下载任何依赖，都是国内速度

✅ 第一步：一、永久配置 NPM 全局国内镜像源（优先级①，所有npm命令自动生效）

操作方式：用【CMD命令提示符】或【PowerShell】执行即可（推荐管理员身份打开）

✔️ 执行以下命令，复制粘贴逐条运行，一键完成所有配置

# 1. 配置npm的核心包下载镜像【全局永久】
npm config set registry https://registry.npmmirror.com

# 2. 配置electron二进制包专属镜像【全局永久，解决electron下载慢的核心配置】
npm config set electron_mirror https://npmmirror.com/mirrors/electron/

# 3. 配置electron-builder二进制包专属镜像【全局永久，解决打包工具下载慢】
npm config set electron-builder-binaries_mirror https://npmmirror.com/mirrors/electron-builder-binaries/

# 4. 额外配置：node编译相关镜像（可选，补充配置，其他依赖也能提速）
npm config set disturl https://npmmirror.com/mirrors/node/

✔️ 验证npm镜像配置是否生效（必做）

执行以下命令，能看到对应的镜像地址，说明配置成功

npm config get registry
npm config get electron_mirror
npm config get electron-builder-binaries_mirror

✔️ 补充：手动修改npm配置文件（防止命令执行失败的备用方案）

如果上面的命令执行报错，直接手动修改配置文件，效果完全一致，永久生效：

1. 打开Windows文件管理器，在地址栏输入：%USERPROFILE% 回车，进入系统用户根目录
2. 找到文件：.npmrc （无后缀的配置文件，没有就新建一个文本文档，重命名为.npmrc，注意删除txt后缀）
3. 右键编辑该文件，粘贴以下内容，保存即可：

   registry=https://registry.npmmirror.com
   electron_mirror=https://npmmirror.com/mirrors/electron/
   electron-builder-binaries_mirror=https://npmmirror.com/mirrors/electron-builder-binaries/
   disturl=https://npmmirror.com/mirrors/node/

✅ 第二步：二、配置【系统环境变量】永久国内镜像源（优先级②，最高优先级，重中之重）

✨ 核心作用：

1. 环境变量的优先级 高于 npm的config配置，能彻底解决「electron/electron-builder 依然下载官方源」的顽固问题
2. 配置后，整个Windows系统全局生效，不管是哪个项目、哪个终端、哪个npm命令，都会强制走国内镜像
3. 不仅是npm，就算用 yarn/pnpm 下载，也能生效，真正做到「一次配置，终身受用」

✔️ 完整操作步骤（Windows 10/11 通用，图文级清晰）

步骤 1：打开系统环境变量配置界面

1. 鼠标右键点击【此电脑】→ 选择【属性】
2. 在弹出的窗口右侧，点击【高级系统设置】
3. 在弹出的「系统属性」窗口，选择【高级】选项卡 → 点击最下方的【环境变量(N)...】

步骤 2：新增【系统级】环境变量（关键！选系统变量，所有用户都生效）

在弹出的「环境变量」窗口中，分两部分，我们只操作【下方的 系统变量】区域，不要动用户变量！

1. 点击【系统变量】下方的【新建(W)...】按钮
2. 依次新增以下 4个核心环境变量，「变量名」和「变量值」必须一字不差，复制粘贴即可

✔️ 新增的4个核心环境变量（全部要加，缺一不可）

① 变量名：REGISTRY

变量值：https://registry.npmmirror.com

② 变量名：ELECTRON_MIRROR

变量值：https://npmmirror.com/mirrors/electron/

③ 变量名：ELECTRON_BUILDER_BINARIES_MIRROR

变量值：https://npmmirror.com/mirrors/electron-builder-binaries/

④ 变量名：DIST_URL

变量值：https://npmmirror.com/mirrors/node/

✔️ 步骤 3：保存并生效环境变量

1. 每新增一个变量，点击【确定】保存；4个变量全部添加完成后，把所有打开的窗口都点【确定】关闭
2. ✅ 重要：重启你的CMD/PowerShell/VSCode/终端，环境变量的配置必须重启终端才能生效！！

✅ 第三步：三、执行你的安装命令（极速下载，无需加任何参数）

✨ 此时你的npm镜像+系统环境变量都已配置完成，无需手动加任何镜像参数，直接执行原命令即可，下载速度拉满，不会再超时/失败

npm install --save-dev electron electron-builder

✔️ 补充：如果之前安装失败，先执行清理缓存命令（可选，推荐执行）

如果之前下载过electron失败，npm会缓存错误文件，先清理缓存再安装，百分百成功：

# 清理npm缓存
npm cache clean --force

# 再执行安装命令
npm install --save-dev electron electron-builder

✅ 第四步：四、镜像配置相关【常用辅助命令】（收藏备用）

✔️ 查看当前所有npm镜像配置

npm config list

✔️ 如需恢复默认官方源（取消国内镜像）

# 清除npm的镜像配置
npm config delete registry
npm config delete electron_mirror
npm config delete electron-builder-binaries_mirror

# 环境变量恢复：打开「环境变量」界面，删除我们新增的4个变量即可

✔️ 检查环境变量是否生效（验证）

打开新的CMD，执行以下命令，能看到配置的镜像地址，说明环境变量生效：

echo %REGISTRY%
echo %ELECTRON_MIRROR%

✅ 五、常见问题解决（避坑指南，100%解决）

❌ 问题1：配置完成后，依然下载慢/超时

✅ 解决：

1. 确认是否重启了终端/VSCode，环境变量必须重启才能生效
2. 确认是否配置的是【系统变量】而不是【用户变量】
3. 执行npm cache clean --force清理缓存后，重新安装

❌ 问题2：electron 提示 Failed to fetch electron

✅ 解决：这个问题是因为只配置了npm镜像，没配置electron专属镜像，我们上面的环境变量里已经加了ELECTRON_MIRROR，配置后必解决

❌ 问题3：electron-builder 打包时下载依赖失败

✅ 解决：我们配置的ELECTRON_BUILDER_BINARIES_MIRROR就是专门解决这个问题的，环境变量生效后，打包时的依赖也会走国内源

✅ 总结（核心要点，一目了然）

✔️ 本次配置的核心优势

1. 「双重保障」：npm全局镜像 + 系统环境变量，优先级全覆盖，彻底杜绝下载失败
2. 「永久生效」：一次配置，以后所有npm命令、所有项目、所有依赖包，全部自动走国内镜像
3. 「针对性解决」：完美适配 electron + electron-builder 这两个特殊包的下载需求
4. 「无副作用」：配置的是国内官方镜像，和官方源完全同步，包无篡改，安全可靠

✔️ 所有配置的核心镜像地址（新版，永久有效）

• npm主镜像：https://registry.npmmirror.com
• electron镜像：https://npmmirror.com/mirrors/electron/
• electron-builder镜像：https://npmmirror.com/mirrors/electron-builder-binaries/

✔️ 最终执行的命令（干净整洁，无需任何额外参数）

npm cache clean --force
npm install --save-dev electron electron-builder

至此，你的系统已经完成了「国内镜像源的全局永久配置」，以后不管下载任何npm包，都是国内极速下载，再也不用为下载慢/失败发愁了！👍

分享到：

赞 (0) 打赏