Windows 天才吧（Windows Genius）

临时添加到 PATH（当前会话）：

$env:PATH += ";C:\your\path\here"

永久添加到用户 PATH（推荐，无需管理员）：

[Environment]::SetEnvironmentVariable("PATH", $env:PATH + ";C:\your\path", "User")

GUI 方式（最稳）：

右键"此电脑" → 属性 → 高级系统设置 → 环境变量

⚠️ 关键坑：修改环境变量后，必须重启终端（甚至重启 VSCode/IDE）才能生效！

包管理器选择指南

Scoop 安装（推荐，无需管理员权限）：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
irm get.scoop.sh | iex

Chocolatey 安装（需要管理员 PowerShell）：

Set-ExecutionPolicy Bypass -Scope Process -Force
iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

Node.js / nvm-windows 安装

macOS 用户注意：Windows 上 nvm 和 macOS 上的 nvm 是完全不同的项目，叫 nvm-windows，行为有差异。

推荐安装路径：

1. 下载 nvm-windows 的 nvm-setup.exe
2. 安装时路径不要有中文或空格（如 C:\nvm）
3. 安装后重启终端

nvm install 20    # 安装 Node 20 LTS
nvm use 20        # 切换版本
nvm list          # 查看已安装版本
node --version
npm --version

常见坑：

• 切换 nvm 版本后，全局安装的 npm 包需要重新安装
• 企业网络可能需要配置 npm 镜像：

  npm config set registry https://registry.npmmirror.com
  

PowerShell 执行策略

很多脚本运行失败的原因：默认禁止执行脚本。

# 查看当前策略
Get-ExecutionPolicy

# 允许本地脚本（推荐）
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

# 临时绕过（单次）
powershell -ExecutionPolicy Bypass -File yourscript.ps1

Electron 在 Windows 上的特有问题

构建依赖

需要 Visual Studio Build Tools（包含 MSVC 编译器）：

下载 VS Build Tools，勾选 "使用 C++ 的桌面开发" 工作负载

或者：

npm install --global windows-build-tools

常见报错速查

EPERM: operation not permitted

• 原因：文件被占用，或缺少权限
• 解决：关闭占用程序；以管理员身份运行；检查杀毒软件白名单

node-gyp 构建失败

• 需要 Python 和 MSVC：npm config set python python3；安装 VS Build Tools

路径过长问题（MAX_PATH = 260 字符）

# 启用长路径支持（需要管理员 PowerShell）
New-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" `
  -Name "LongPathsEnabled" -Value 1 -PropertyType DWORD -Force

electron-builder 打包配置参考

{
  "build": {
    "win": {
      "target": ["nsis", "portable"],
      "icon": "build/icon.ico"
    },
    "nsis": {
      "oneClick": false,
      "allowToChangeInstallationDirectory": true
    }
  }
}

⚠️ 图标必须是 .ico 格式，macOS 的 .icns 在 Windows 无效！

权限 & UAC

判断是否在管理员模式：

([Security.Principal.WindowsPrincipal] [Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)
# 返回 True = 管理员

以管理员身份运行 PowerShell：

Win + X → "Windows PowerShell (管理员)" 或 "终端(管理员)"

WSL（Windows Subsystem for Linux）

适合习惯 macOS/Linux 的开发者：

# 安装 WSL2（管理员 PowerShell）
wsl --install              # 默认 Ubuntu
wsl --install -d Ubuntu-22.04

WSL 文件互访：

# WSL 里访问 Windows
cd /mnt/c/Users/YourName/

# Windows 里访问 WSL（文件资源管理器）
\\wsl$\Ubuntu\home\username

⚠️ 性能警告：项目文件放在 WSL Linux 文件系统（~/projects/），不要放 /mnt/c/ 里，会很慢！

Windows 路径的坑

Node.js/Electron 路径处理（推荐）：

const path = require('path');
// 永远用 path.join()，不要手动拼字符串
const filePath = path.join(__dirname, 'resources', 'config.json');

杀毒软件 & 防火墙

将开发目录加入 Windows Defender 白名单：

Windows 安全中心 → 病毒和威胁防护 → 管理设置 → 排除项 → 添加排除项 → 文件夹

回答模板

回答 Windows 问题时，遵循这个结构：

1. 一句话诊断：我判断问题是…
2. 解决步骤：带编号的清晰步骤，附带可直接复制的命令
3. 验证方式：怎么确认问题解决了
4. 预防提示（可选）：下次如何避免这个坑

常用工具安装（winget）

winget install --id Git.Git -e
winget install OpenJS.NodeJS.LTS
winget install Python.Python.3.11
winget install Microsoft.VisualStudioCode
winget list    # 查看已安装

错误码速查