项目开发前置环境准备

1. 生成 SSH 密钥（所有系统通用）： 打开你的终端（Terminal、Git Bash、或麒麟/统信的终端），输入以下命令：

Bash

# 使用你的邮箱替换 "your_email@example.com"
ssh-keygen -t rsa -C "your_email@example.com"

然后一路按回车即可。这会在你的用户主目录下的 .ssh 文件夹中生成两个文件：

• id_rsa：私钥，请妥善保管，不要泄露。
• id_rsa.pub：公钥，需要将其内容复制到你的代码托管平台（如 Gitee 或 GitHub）的 SSH Keys 设置中。

查看并复制公钥：

Bash

cat ~/.ssh/id_rsa.pub

将输出的 ssh-rsa

2. NVM (Node Version Manager)

• NVM: 是一个 Node.js 的版本管理工具。Electron 项目可能依赖特定版本的 Node.js，使用 NVM 可以让你在同一台电脑上轻松安装和切换多个 Node.js 版本。
• 注意 : Windows 平台使用的是一个独立的、功能相似但非官方的工具 nvm-windows。

3. 中国区镜像源配置

为了加速下载，我们需要为 npm、Node.js 本身以及 Electron 的二进制文件设置国内镜像。

1. NPM/Yarn 镜像源 (淘宝镜像)

   Bash

   # NPM 设置
   npm config set registry https://registry.npmmirror.com/
   
   # Yarn 设置 (如果使用 Yarn)
   yarn config set registry https://registry.npmmirror.com/

2. NVM/Node.js 下载镜像源 在安装 NVM 或使用 NVM 安装 Node.js 时，需要设置环境变量，指向国内镜像。

   • Node.js 安装镜像 : NVM_NODEJS_ORG_MIRROR
   • Electron 二进制文件下载镜像 : ELECTRON_MIRROR

   推荐的镜像地址:

   • NVM_NODEJS_ORG_MIRROR: https://npmmirror.com/mirrors/node/
   • ELECTRON_MIRROR: https://npmmirror.com/mirrors/electron/

   如何设置这些环境变量，我们将在下面的分系统指南中详细说明。

Part 2: 分操作系统安装指南

A. macOS 环境准备

macOS 自带 Zsh作为默认 Shell，配置文件是 ~/.zshrc。

1. 安装 Homebrew (可选但推荐) Homebrew 是 macOS 的包管理器，能简化很多工具的安装。

   Bash

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. 安装 Git macOS 通常自带 Git，但版本可能较旧。可以通过 Xcode Command Line Tools 或 Homebrew 安装。

   Bash

   # 方式一：通过 Xcode Command Line Tools (推荐)
   xcode-select --install
   
   # 方式二：通过 Homebrew
   brew install git

3. 安装 NVM 使用官方脚本安装，但为了加速，可以从 Gitee 镜像下载脚本。

   Bash

   # 从 Gitee 镜像安装 NVM，避免 'raw.githubusercontent.com' 访问慢的问题
   curl -o- "https://gitee.com/mirrors/nvm/raw/master/install.sh" | bash

   安装完成后，根据提示，将以下几行代码添加到 ~/.zshrc 文件中：

   Bash

   export NVM_DIR="$([ -z "${XDG_CONFIG_HOME-}" ] && printf %s "${HOME}/.nvm" || printf %s "${XDG_CONFIG_HOME}/nvm")"
   [ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh" # This loads nvm

4. 配置镜像源环境变量 编辑 ~/.zshrc 文件 (vim ~/.zshrc 或 code ~/.zshrc)，在文件末尾添加：

   Bash

   # Node.js and Electron Mirrors for China
   export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node/
   export ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/

   保存后，执行 source ~/.zshrc 使配置生效。

5. 安装 Node.js

   Bash

   # 安装一个长期支持版 (LTS)，例如
   nvm install --lts
   
   # 设为默认版本
   nvm use --lts
   nvm alias default lts/*

B. Windows 环境准备

Windows 推荐使用 Git Bash 作为主要的命令行工具，它提供了一个强大的类 Unix 环境。

1. 安装 Git for Windows 访问官网 git-scm.com/download/wi... 下载安装包。安装过程中，请一路 Next，它会自动安装 Git Bash。

2. 安装 nvm-windows 这是一个与 NVM 独立的 Windows 版本。

   • 访问其 GitHub Releases 页面。
   • 下载最新的 nvm-setup.zip 文件并解压安装。
   • 安装路径中 不要有空格或中文字符。

3. 配置镜像源

   • NPM 镜像 : 打开 CMD 或 PowerShell 执行 npm config set registry https://registry.npmmirror.com/。

   • Node.js 镜像 : 在 nvm-windows 的安装目录下，找到 settings.txt 文件，添加以下两行：

     node_mirror: https://npmmirror.com/mirrors/node/
     npm_mirror: https://npmmirror.com/mirrors/npm/

   • Electron 镜像: 设置系统环境变量。

     • 右键"此电脑" -> "属性" -> "高级系统设置" -> "环境变量"。
     • 在"系统变量"或"用户变量"中，点击"新建"。
     • 变量名：ELECTRON_MIRROR
     • 变量值：https://npmmirror.com/mirrors/electron/

4. 安装 Node.js 打开一个新的 CMD 或 PowerShell (不是 Git Bash) 执行：

   PowerShell

   # 查看可用的 LTS 版本
   nvm list available
   
   # 安装一个 LTS 版本
   nvm install 18.17.0 # 替换为你想要的版本
   
   # 使用该版本
   nvm use 18.17.0

C. 麒麟 (Kylin) / 统信 (UOS) 环境准备

麒麟和统信都是基于 Debian/Linux 的发行版，操作基本一致。默认 Shell 通常是 Bash，配置文件是 ~/.bashrc。

1. 安装 Git 打开终端，执行以下命令：

   Bash

   sudo apt update
   sudo apt install git -y

2. 安装 NVM 与 macOS 方法相同，使用 Gitee 镜像的脚本安装。

   Bash

   # 从 Gitee 镜像安装 NVM
   curl -o- "https://gitee.com/mirrors/nvm/raw/master/install.sh" | bash

   安装完成后，将提示中的代码复制到 ~/.bashrc 文件中，通常是：

   Bash

   export NVM_DIR="$HOME/.nvm"
   [ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"  # This loads nvm
   [ -s "$NVM_DIR/bash_completion" ] && . "$NVM_DIR/bash_completion"  # This loads nvm bash_completion

3. 配置镜像源环境变量 编辑 ~/.bashrc 文件 (vim ~/.bashrc 或 gedit ~/.bashrc)，在文件末尾添加：

   Bash

   # Node.js and Electron Mirrors for China
   export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node/
   export ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/

   保存后，执行 source ~/.bashrc 使配置生效。

4. 安装 Node.js 与 macOS 方法完全相同。

   Bash

   # 安装 LTS 版本
   nvm install --lts
   
   # 使用并设为默认
   nvm use --lts
   nvm alias default lts/*

---

Part 3: 环境验证与项目初始化

完成上述步骤后，在你的目标系统上打开一个新的终端窗口进行验证。

1. 验证安装

   Bash

   git --version          # 应显示 Git 版本
   nvm --version          # 或 nvm version (Windows)，应显示 NVM 版本
   node -v                # 应显示 Node.js 版本
   npm -v                 # 应显示 NPM 版本
   npm config get registry # 应显示 https://registry.npmmirror.com/

2. 创建第一个 Electron 项目

   Bash

   # 1. 创建项目文件夹
   mkdir my-electron-app && cd my-electron-app
   
   # 2. 初始化 Git 仓库
   git init
   
   # 3. 初始化 npm 项目
   npm init -y
   
   # 4. 安装 Electron
   # 此时会自动使用之前配置的 ELECTRON_MIRROR 和 NPM 镜像，速度会很快
   npm install --save-dev electron

   如果 npm install electron 能够快速顺利地完成，说明你的所有镜像配置都已生效。

总结

工具/配置	macOS	Windows	麒麟/统信 (Linux)	备注
Git 安装	xcode-select --install	Git for Windows 安装包	sudo apt install git	-
SSH 密钥	ssh-keygen	ssh-keygen (in Git Bash)	ssh-keygen	操作完全一样
NVM 安装	curl 脚本	nvm-windows 安装包	curl 脚本	Windows 版本是独立项目
NPM 镜像	npm config set ...	npm config set ...	npm config set ...	命令完全一样
环境变量	编辑 ~/.zshrc	系统环境变量 GUI / settings.txt(nvm)	编辑 ~/.bashrc	这是主要区别点
Node.js 安装	nvm install ...	nvm install ...	nvm install ...	命令基本一致

按照以上步骤操作，你就可以在四个平台上都搭建好一套高效、稳定的 Electron 开发环境了。祝你开发顺利！