Windows 11搭建Node.js开发环境需安装LTS版、配置npm全局路径、修复PowerShell执行策略及UTF-8编码：下载node-v20.18.0-x64.msi，勾选Add to PATH和自动工具安装；运行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser；配置prefix与cache至D盘；执行[Console]::OutputEncoding = [System.Text.Encoding]::UTF8并设npm unicode true；最后全局安装pnpm。
在 Windows 11 上搭建 Node.js 开发环境，需确保安装官方支持的 LTS 版本、正确配置 npm 全局路径、并验证终端编码与执行策略兼容性，否则后续运行脚本或安装包时会报错“无法加载文件”或中文乱码。
下载并安装 Node.js 官方安装包
访问 nodejs.org → 点击绿色【Download Node.js LTS】按钮 → 下载 .msi 安装包（如 node-v20.18.0-x64.msi）→ 双击运行。
安装时务必勾选 “Add to PATH” 和 “Automatically install the necessary tools”（该选项会一并安装 Python 3.11 和 Visual Studio Build Tools 的精简版，用于编译原生模块）。
【不勾选这两项会导致 npm 命令不可用、后续安装 bcrypt 或 sqlite3 等包时直接失败】
验证安装并修复 PowerShell 执行策略
打开 Windows Terminal（管理员权限），依次执行：
node -v → 应输出 v20.x.x；npm -v → 应输出 10.x.x。
若执行 npm init 报错 “xxx.ps1 cannot be loaded because running scripts is disabled”，说明 PowerShell 执行策略过严。此时运行：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
这一步必须做，否则所有基于 npm script 的开发流程（如 vite dev、next dev）都会中断。普通用户权限即可执行，无需管理员——但若你当前是标准用户且策略被域组策略锁定，则需联系 IT 部门。
配置 npm 全局模块存储路径（避免 C 盘爆满）
方法一：命令行重定向
mkdir D:
pm-global → npm config set prefix "D:
pm-global" → npm config set cache "D:
pm-cache"
方法二：手动编辑配置文件
运行 npm config get userconfig → 得到路径（如 C:UsersNameAppDataRoaming
pmetc
pmrc），用记事本打开，在末尾新增两行：
prefix=D:\npm-global
cache=D:\npm-cache
完成后重启终端，执行 npm install -g pnpm，验证是否真写入 D 盘——查看 D: pm-global ode_modules 是否出现 pnpm 文件夹。
解决 Windows 11 下中文乱码与终端编码问题
第一步：确认 PowerShell 使用 UTF-8
在 PowerShell 中运行 [Console]::OutputEncoding → 若返回 System.Text.SBCSCodePageEncoding，说明仍在用 GBK。立即执行：
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
第二步：永久生效（仅对新启动的 PowerShell 有效）
新建文件 C:UsersYourNameDocumentsPowerShellMicrosoft.PowerShell_profile.ps1，写入：
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
第三步：强制 npm 日志使用 UTF-8
npm config set unicode true → 此设置可防止 npm ls 或 npm audit 输出中文为 符号。
注意：此配置不影响 CMD，如需在 CMD 中正常使用中文，需额外执行 chcp 65001，但 CMD 已不推荐作为 Node.js 开发主终端。
安装 pnpm 并设为默认包管理器
① 运行 npm install -g pnpm
② 验证：pnpm -v → 输出 9.x.x
③ 设置项目级默认：pnpm set registry https://registry.npmjs.org/
④ （可选）全局启用严格模式：pnpm config set strict-peer-dependencies true
pnpm 比 npm/yarn 更适合 Windows 11：硬链接节省磁盘空间，symlink 支持更稳定，且对 WSL Containers 和 Windows Terminal 的 UTF-8 处理更鲁棒。安装完后，后续所有新项目都应使用 pnpm create vite 而非 npm create vite。
