项目开发前置环境准备

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

Bash

perl 复制代码

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

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

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

查看并复制公钥：

Bash

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 的二进制文件设置国内镜像。

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

Bash

arduino 复制代码

# NPM 设置
npm config set registry https://registry.npmmirror.com/

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

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。

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

Bash
bash 复制代码
```
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```
安装 Git macOS 通常自带 Git，但版本可能较旧。可以通过 Xcode Command Line Tools 或 Homebrew 安装。

Bash
perl 复制代码
```
# 方式一：通过 Xcode Command Line Tools (推荐)
xcode-select --install

# 方式二：通过 Homebrew
brew install git
```

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

Bash

arduino 复制代码

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

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

Bash

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

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

Bash
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 使配置生效。

安装 Node.js

Bash

csharp 复制代码

# 安装一个长期支持版 (LTS)，例如
nvm install --lts

# 设为默认版本
nvm use --lts
nvm alias default lts/*

B. Windows 环境准备

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

安装 Git for Windows 访问官网 git-scm.com/download/wi... 下载安装包。安装过程中，请一路 Next，它会自动安装 Git Bash。
安装 nvm-windows 这是一个与 NVM 独立的 Windows 版本。
- 访问其 GitHub Releases 页面。
- 下载最新的 nvm-setup.zip 文件并解压安装。
- 安装路径中 不要有空格或中文字符。
配置镜像源
- NPM 镜像 : 打开 CMD 或 PowerShell 执行 npm config set registry https://registry.npmmirror.com/。
- Node.js 镜像 : 在 nvm-windows 的安装目录下，找到 settings.txt 文件，添加以下两行：
  ruby 复制代码
```
node_mirror: https://npmmirror.com/mirrors/node/
npm_mirror: https://npmmirror.com/mirrors/npm/
```
- Electron 镜像: 设置系统环境变量。
  - 右键"此电脑" -> "属性" -> "高级系统设置" -> "环境变量"。
  - 在"系统变量"或"用户变量"中，点击"新建"。
  - 变量名：ELECTRON_MIRROR
  - 变量值：https://npmmirror.com/mirrors/electron/

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

PowerShell

perl 复制代码

# 查看可用的 LTS 版本
nvm list available

# 安装一个 LTS 版本
nvm install 18.17.0 # 替换为你想要的版本

# 使用该版本
nvm use 18.17.0

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

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

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

Bash
sql 复制代码
```
sudo apt update
sudo apt install git -y
```

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

Bash

bash 复制代码

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

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

Bash

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

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

Bash
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 使配置生效。

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

Bash

csharp 复制代码

# 安装 LTS 版本
nvm install --lts

# 使用并设为默认
nvm use --lts
nvm alias default lts/*

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

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

验证安装

Bash

csharp 复制代码

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

创建第一个 Electron 项目

Bash

perl 复制代码

# 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 开发环境了。祝你开发顺利！

项目开发前置环境准备

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

2. NVM (Node Version Manager)

3. 中国区镜像源配置

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

A. macOS 环境准备

B. Windows 环境准备

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

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

总结

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