前置要求
| 組件 | 版本要求 | 說明 |
|---|
| Node.js | LTS 版本 (如 18.x/20.x) | 官網下載 .msi 安裝包，自動配置 PATH |
| Python | 2.7.x (2.5 < v < 3.0) | node-gyp 需要，安裝時勾選 "Add to PATH" |
| Visual Studio | VS 2017/2019/2022 Community | 需勾選 "C++ 桌面開發" 工作負載 |
| Windows SDK | 10.0.17763+ | VS 安裝器自動勾選 |
安裝步驟
1. 安裝 Node.js
- 下載： → Windows Installer (.msi) 64-bit
- 安裝：全部默認下一步，自動添加到 PATH
- 驗證：`node -v`、`npm -v`
2. 安裝構建工具 (關鍵)
# 管理員 PowerShell 運行
npm install --global --production windows-build-tools
# 這會自動安裝 Python 2.7 + VS Build Tools (若未裝 VS)
# 耗時較久，請耐心等待
3. 安裝 Pomelo
npm install -g pomelo
# 或項目內安裝
npm install pomelo --save
4. 創建項目測試
pomelo init mygame
cd mygame
npm install
pomelo start
常見坑與解決
| 報錯 | 原因 | 解決 |
|---|
| MSBUILD : error MSB3428 | 缺少 VC++ 編譯器 | 安裝 VS Build Tools 或完整 VS，勾選 C++ 工作負載 |
| gyp ERR! find Python | Python 未安裝或不在 PATH | 安裝 Python 2.7，勾選 Add to PATH；或 `npm config set python python2.7` |
| Error: ENOENT: no such file or directory 'python' | 同上 | 同上 |
| pomelo: command not found | npm global bin 不在 PATH | 重啟終端；或 `npm config get prefix` 確認路徑並手動加入 PATH |
| binding.gyp not found | 原生模塊編譯失敗 | 確保 windows-build-tools 成功，刪除 node_modules 重裝 |
Windows 7 特別說明
- ✅ Win7 SP1 + 所有補丁是基礎
- ✅ Node.js 18+ 官方不再支持 Win7，建議用 Node 16.x LTS (最後支持 Win7 的版本)
- ✅
- ✅ VS2019 是最後支持 Win7 的 VS 版本
驗證安裝成功
> node -v
v16.20.2
> npm -v
8.19.4
> pomelo -v
0.8.1
> pomelo init test && cd test && npm install && pomelo start
# 控制台輸出 "pomelo server started" 即成功
Win7 開發環境配齊 Python 2.7 + VS2019 C++ + Node 16 LTS，Pomelo 安裝無阻礙。
