Files
tianshu-engine/docs/mirror-setup-summary.md
2026-06-10 14:16:46 +08:00

3.0 KiB
Raw Blame History

Electron 镜像源配置完成

🎉 问题已解决

你的项目已经成功配置了国内镜像源,无需翻墙即可打包

📋 配置清单

已配置的文件

  1. 项目根目录 .npmrc

    • npm 镜像源:淘宝镜像
    • Electron 镜像源:淘宝镜像
    • Electron Builder 镜像源:淘宝镜像
  2. electron 目录 .npmrc

    • Electron 镜像源:淘宝镜像
    • Electron Builder 镜像源:淘宝镜像
    • npm 镜像源:淘宝镜像
  3. electron/package.json

    • 安装了 cross-env
    • 打包脚本中设置了环境变量
  4. 辅助脚本

    • scripts/verify-mirrors.cjs - 验证镜像源配置
    • scripts/pack-win.bat - Windows 打包脚本
    • scripts/pack-mac.sh - Mac 打包脚本

🔍 验证结果

✅ npm 配置:
  registry: https://registry.npmmirror.com
  electron_mirror: https://npmmirror.com/mirrors/electron/
  electron_builder_binaries_mirror: https://npmmirror.com/mirrors/electron-builder-binaries/

✅ 已配置国内镜像源,无需翻墙即可打包!

🚀 现在可以直接打包

Windows

npm run pack:win

Mac

npm run pack:mac

📝 工作原理

之前(需要翻墙)

npm run pack:win
↓
下载 Electron 二进制文件
↓
访问 GitHub releases (github.com)
↓
❌ 失败fetch failed

现在(无需翻墙)

npm run pack:win
↓
下载 Electron 二进制文件
↓
访问淘宝镜像 (npmmirror.com)
↓
✅ 成功:打包完成

🛠️ 配置详情

镜像源地址

资源 原地址 镜像地址
Electron github.com/electron/electron/releases npmmirror.com/mirrors/electron/
Electron Builder github.com/electron-userland/electron-builder-binaries npmmirror.com/mirrors/electron-builder-binaries/
npm registry.npmjs.org registry.npmmirror.com

环境变量

打包时会自动设置以下环境变量:

ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/
ELECTRON_BUILDER_BINARIES_MIRROR=https://npmmirror.com/mirrors/electron-builder-binaries/

🔧 如果仍然失败

1. 清除缓存

npm cache clean --force

2. 重新安装依赖

cd electron
rm -rf node_modules
npm install

3. 验证配置

node scripts/verify-mirrors.cjs

4. 检查网络

确保能访问:

📚 相关文档

🎯 总结

通过配置国内镜像源,你现在已经可以:

无需翻墙 - 直接打包 Electron 应用 快速下载 - 使用国内 CDN速度快 稳定可靠 - 镜像源稳定,不易中断 一次配置 - 配置一次,永久生效

现在你可以愉快地打包 Electron 应用了!🎉