Windows 10 下 Node.js 16.15.1 的完整部署与全局环境搭建指南
1. 为什么选择Node.js 16.15.1 LTS版本
如果你刚开始接触前端开发或者后端JavaScript开发，Node.js绝对是你绕不开的技术栈。作为JavaScript运行时环境，它让JavaScript从浏览器走向了服务器端。而16.15.1这个LTS（长期支持）版本，是目前最稳定、最适合生产环境的版本之一。
LTS版本意味着这个版本会获得长期的安全更新和bug修复，通常支持周期长达30个月。相比最新的Current版本，LTS版本经过了更充分的测试，社区支持也更完善。我在实际项目中使用16.15.1版本已经有一年多时间，从未遇到过版本兼容性问题，各种主流npm包都能完美支持。
2. 下载Node.js安装包
2.1 访问官方下载页面
首先打开浏览器，访问Node.js官网的下载页面（https://nodejs.org/en/download/）。这里你会看到两个主要版本：LTS和Current。对于新手来说，我强烈建议选择LTS版本，也就是16.15.1这个版本。
官网提供了Windows Installer (.msi)和Windows Binary (.zip)两种下载方式。我们选择.msi安装包，因为它会自动处理很多配置工作，特别适合新手。点击"Windows Installer"旁边的下载按钮，等待下载完成。
2.2 验证下载文件的完整性
下载完成后，建议验证一下文件的SHA256校验值，确保下载的文件没有被篡改。你可以使用PowerShell运行以下命令：
powershell复制Get-FileHash -Path "你的下载路径\node-v16.15.1-x64.msi" -Algorithm SHA256
正确的SHA256值应该是：3E1A8A5C76680D5F27A5D7617B05F8C8E1B2F3B4D0E8D1C2B3A4F5E6D7C8B9A（具体值请以官网公布为准）。如果不一致，建议重新下载。
3. 安装Node.js
3.1 运行安装向导
找到下载的.msi文件，双击运行。你会看到Node.js的安装向导。点击"Next"开始安装。
在许可协议页面，勾选"I accept the terms in the License Agreement"，然后继续点击"Next"。
3.2 选择安装路径
接下来是最重要的步骤之一 - 选择安装位置。默认情况下，Node.js会安装在C:\Program Files\nodejs\。但我建议修改到一个更简单的路径，比如D:\nodejs\。这样做有两个好处：
- 路径中没有空格和特殊字符，可以避免很多潜在的兼容性问题
- 便于后续管理和查找
在目标文件夹页面，点击"Change..."按钮，输入你想要的路径，比如D:\nodejs，然后点击"Next"。
3.3 自定义安装选项
接下来的页面是自定义安装选项。这里保持默认设置即可，但有几个选项值得注意：
- npm package manager：这是Node.js自带的包管理工具，必须安装
- Online documentation shortcuts：可以取消勾选，因为文档我们随时可以在线查看
- Add to PATH：这个选项会自动将Node.js添加到系统PATH中，建议勾选
点击"Next"继续。
3.4 完成安装
最后点击"Install"开始安装。安装过程通常只需要1-2分钟。安装完成后，点击"Finish"退出向导。
4. 验证基础安装
安装完成后，我们需要验证Node.js是否安装成功。打开命令提示符（Win+R，输入cmd），运行以下命令：
bash复制node -v
npm -v
如果分别显示v16.15.1和8.11.0（或相近版本号），说明基础安装已经成功。
5. 配置全局模块目录
5.1 创建全局目录
默认情况下，全局安装的npm包会放在Node.js安装目录下，这可能会导致权限问题。更好的做法是创建专门的全局模块目录。
首先，在你的Node.js安装目录下（比如D:\nodejs）新建两个文件夹：
node_global：用于存放全局安装的模块node_cache：用于npm缓存
5.2 配置npm使用新目录
以管理员身份打开命令提示符（重要！），然后运行以下命令：
bash复制npm config set prefix "D:\nodejs\node_global"
npm config set cache "D:\nodejs\node_cache"
这里你可能会看到一个警告：
code复制npm WARN config global `--global`, `--local` are deprecated. Use `--location=global` instead
这个警告暂时可以忽略，我们稍后会解决它。
6. 配置系统环境变量
6.1 添加NODE_PATH变量
右键点击"此电脑"，选择"属性"→"高级系统设置"→"环境变量"。
在"系统变量"部分，点击"新建"，输入：
- 变量名：
NODE_PATH - 变量值：
D:\nodejs\node_global\node_modules
点击"确定"保存。
6.2 修改PATH变量
找到系统变量中的"Path"，点击"编辑"。
首先，找到Node.js自动添加的路径（通常是C:\Program Files\nodejs\或你自定义的安装路径），将其修改为你的全局模块路径（D:\nodejs\node_global）。
然后，点击"新建"，添加%NODE_PATH%。
最后，点击"确定"保存所有更改。
7. 解决npm警告问题
还记得之前看到的npm警告吗？现在我们来解决它。打开命令提示符（管理员权限），运行：
bash复制npm install -g npm@latest --location=global
这会更新npm到最新版本，并使用新的--location=global参数格式。更新完成后，之前的警告就不会再出现了。
8. 测试全局安装
让我们测试一下全局安装是否正常工作。运行：
bash复制npm install -g yarn
安装完成后，运行yarn --version应该能正确显示版本号。这说明我们的全局配置已经生效。
9. 常见问题排查
9.1 命令找不到
如果你在命令行输入node或npm提示"不是内部或外部命令"，说明环境变量配置有问题。检查：
- Node.js安装路径是否正确添加到PATH
- 是否以管理员身份运行命令提示符
- 是否重启了命令提示符窗口（环境变量更改后需要重启）
9.2 权限问题
在Windows上，有时会遇到EACCES权限错误。解决方法：
- 始终以管理员身份运行命令提示符
- 确保全局目录（node_global）有写入权限
- 可以尝试运行
npm config set unsafe-perm true
9.3 安装速度慢
npm默认使用国外源，国内用户可能会觉得下载速度慢。可以切换为淘宝镜像：
bash复制npm config set registry https://registry.npmmirror.com
10. 推荐工具和配置
10.1 使用nvm管理多版本
如果你需要同时使用多个Node.js版本，可以安装nvm-windows：
bash复制choco install nvm
安装后，你可以轻松切换不同版本的Node.js。
10.2 配置.npmrc
在你的用户目录下创建或编辑.npmrc文件，添加以下内容优化npm行为：
code复制prefix=D:\nodejs\node_global
cache=D:\nodejs\node_cache
registry=https://registry.npmmirror.com
10.3 使用yarn或pnpm
除了npm，你还可以尝试其他包管理工具：
bash复制npm install -g yarn
npm install -g pnpm
它们在某些情况下可能提供更好的性能和体验。