
## 一、前置环境（只需一次）
如果你已经有，直接跳到第二部分。

### 1️⃣ 安装 Node.js（必须）
- 建议 **LTS 版本**
- 下载：[https://nodejs.org](https://nodejs.org/)
- 安装后验证：
```bash
node -v
npm -v
```

---

## 二、快速启动一个「已有的」Electron 项目（最常见）
假设你已经 clone / 下载了项目。

### 1️⃣ 用终端快速进入项目
**最快方式（推荐）**
- 在项目文件夹 **空白处**
- `Shift + 右键`
- 选择 👉 **“在此处打开 PowerShell 窗口”**（或 Windows Terminal）

---

### 2️⃣ 安装依赖
```bash
npm install
```
（或项目用的是 yarn / pnpm）
```bash
yarn
pnpm install
```

---

### 3️⃣ 启动 Electron
最常见的几种命令：
```bash
npm start
npm run dev
npm run electron:dev
```

👉 **不知道用哪个？**  
看 `package.json` 里的 `scripts`：
```json
"scripts": {
  "start": "electron .",
  "dev": "vite",
  "electron:dev": "electron ."
}
```

---

## 三、从 0 到 1新建一个 Electron 项目

### 方案 A：官方推荐（现代）
```bash
npm create electron-app my-app
cd my-app
npm start
```

---

### 方案 B：Electron + Vite（前端更爽）
```bash
npm create electron-vite
cd electron-vite-project
npm install
npm run dev
```

---

## 四、Windows 上「更快」的小技巧 ⚡

### 🔹 1. 设置 npm 镜像（国内必做）
```bash
npm config set registry https://registry.npmmirror.com
```

---

## 五、常见卡点排雷 🔥

|问题|解决|
|---|---|
|`electron: command not found`|用 `npx electron .`|
|安装慢|换 npm 镜像|
|白屏|看 `main.js / preload.js` 是否报错|
|启动闪退|终端错误信息很关键|

---

