Windows系统安装Node.js详细步骤与环境验证

一、安装前准备与版本选型（LTS 与 Current）

在下载安装程序之前，需要在官方提供的两种版本类型之间做出判断。访问 Node.js 官方网站（nodejs.org）时，首页通常会提供两个醒目的下载按钮：左侧为 LTS（Long Term Support，长期支持版），右侧为 Current（最新特性尝鲜版）。

这两个版本面向完全不同的使用场景：

• LTS 长期支持版（强烈推荐）：版本号为主版本偶数（例如 v18、v20、v22）。进入 LTS 阶段后，该版本享有长达 30 个月的维护期。在此期间，官方仅修复严重安全漏洞和稳定性缺陷，不会引入破坏现有代码的重大破坏性 API 变动。无论是日常学习、企业团队协作，还是运行 Vue、React、Next.js 等前端项目，都应首选 LTS 版本。
• Current 最新尝鲜版：包含最新的 ECMAScript 语法支持和实验性内部模块，每隔 6 个月便会有新的分支产生。部分 npm 第三方依赖包（尤其是需要原生 C++ 编译的底层插件）可能尚未适配 Current 版本，初学者在安装此类扩展时容易遇到编译报错。

二、Windows 官方安装包（.msi）详细安装步骤

获取安装包后，双击运行 .msi 文件即可启动安装向导。整个向导包含 5 个主要交互界面，按照以下步骤依次操作即可完成配置。

第 1 步：欢迎界面与许可协议

双击运行安装包后，首先弹出“Welcome to the Node.js Setup Wizard”欢迎界面，点击 Next。在接下来的“End-User License Agreement”界面中，勾选 I accept the terms in the License Agreement（我接受许可协议中的条款），然后点击 Next 继续。

第 2 步：选择安装路径（Destination Folder）

向导默认将软件安装到 C:\Program Files odejs\ 目录下。

• 默认推荐：直接保持默认路径即可。该路径具备完善的系统权限管理，能够避免多用户权限混乱。
• 自定义磁盘提醒：如果系统盘（C盘）空间紧张，可以点击 Change... 按钮将其指定到其他分区（例如 D:\Develop odejs\）。必须确保目标路径中不包含中文字符、空格或特殊符号，否则后续运行部分依赖特定路径转义的 npm 脚本时可能会解析失败。

第 3 步：自定义功能与“Add to PATH”确认（Custom Setup）

Custom Setup 界面列出了安装包包含的功能模块：

• Node.js runtime：核心 JavaScript 运行时引擎。
• corepack：管理 Yarn、pnpm 等现代包管理器的工具。
• npm package manager：随 Node.js 一同分发的核心包管理器。
• Online documentation shortcuts：官方在线文档快捷方式。
• Add to PATH：将 Node.js 和 npm 的可执行路径写入系统环境变量。

默认状态下，这些功能均处于勾选启用状态。请务必确认 Add to PATH 未被禁用，这样可以免去后续手动打开系统属性配置环境变量的步骤。确认无误后点击 Next。

第 4 步：原生编译工具选择（Tools for Native Modules，关键避坑项）

向导接下来会呈现一个单独的选项页：“Tools for Native Modules”。该页面包含一个复选框：Automatically install the necessary tools. Note that this will also install Chocolatey...。

第 5 步：确认执行安装与提权

进入“Ready to install Node.js”界面后，点击 Install 按钮。此时 Windows 系统会弹出“用户账户控制（UAC）”窗口，询问是否允许该应用对设备进行更改，点击“是”确认提权。等待进度条写入文件，完成后点击 Finish 退出向导。

三、Windows PATH 环境变量注入与终端命令寻址机制

在安装过程中，向导完成了一项至关重要的底层操作：修改 Windows 注册表中的环境变量。理解这一机制有助于排查后续可能遇到的“命令未找到”问题。

当在 Windows 终端（命令提示符 CMD 或 PowerShell）中敲下 node 并回车时，操作系统并不是凭空找到该程序的。其底层寻址逻辑如下：

1. 检查内置命令：判断 node 是否属于 Shell 自身的内置指令（如 cd, dir）。
2. 检索当前工作目录：在终端当前所在的路径下查找是否存在 node.exe。
3. 逐层遍历 PATH 环境变量：如果当前目录没有，Windows 开始按照注册表中声明的顺序，依次检索系统环境变量 PATH 和用户环境变量 PATH 中的所有目录路径。

MSI 安装向导在系统 PATH 中自动追加了 C:\Program Files odejs\，该目录下存放着 node.exe 以及 npm.cmd 批处理脚本。同时，在用户级别的 PATH 中追加了 %APPDATA% pm，这是后续通过 npm install -g 全局安装各种命令行工具时的二进制入口所在目录。

四、命令行环境验证与快速运行测试

安装完成后，必须通过终端验证安装的有效性。按键盘上的快捷键 Win + R 打开运行对话框，输入 powershell 或 cmd 并按回车，打开终端。

1. 检查 Node.js 运行时版本

在终端中输入以下命令并回车：

PS C:\Users\Developer> node -v
# 示例输出：
v20.18.0

能够打印出以字母 v 开头的版本号，说明 Node.js 核心运行时已成功安装并且已被系统 PATH 变量正确识别。

2. 检查 npm 包管理器版本

紧接着输入检查 npm 版本的指令：

PS C:\Users\Developer> npm -v
# 示例输出：
10.8.2

输出形如 10.x.x 的纯数字版本号，表明随附的 npm 依赖包管理工具已完成环境初始化。

3. 单行代码即时执行验证

除了查看版本号，还可以通过 -e 参数让 Node.js 运行时直接解析并执行一段 JavaScript 表达式：

PS C:\Users\Developer> node -e "console.log('Node.js runtime is working on Windows!')"
# 示例输出：
Node.js runtime is working on Windows!

终端能够正常打印出指定字符串，证明 V8 引擎解析器和标准输入输出流工作正常。

4. 交互式解释器（REPL）体验

在终端输入 node 并按回车（不带任何参数），会进入 Node.js 交互式执行环境（REPL）：

PS C:\Users\Developer> node
Welcome to Node.js v20.18.0.
Type ".help" for more information.
> const os = require('os');
undefined
> `Running on ${os.type()} ${os.arch()} with ${os.cpus().length} cores`
'Running on Windows_NT x64 with 8 cores'
> .exit

在此环境下可以自由输入任何 JavaScript 语法进行调试。输入 .exit 或者连续按下两次 Ctrl + C 即可退出 REPL 回到正常的 Windows 终端。

五、常见问题与排查修复指南

在部分特定的 Windows 系统配置下，安装后可能会遇到以下两类典型问题，可按照对应方案排查修复。

关于 PowerShell 脚本执行策略拦截的补充说明

现代 Windows 10/11 系统的 PowerShell 出于安全性考虑，默认可能禁止执行未签名的脚本。当使用 npm 全局安装的命令（例如 pnpm, yarn, vite）时，PowerShell 可能会拦截对 *.ps1 文件的调用。

执行 Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned 命令仅将当前登录用户的权限放宽至“允许运行本地创建的脚本和经过签名的远程脚本”，既解决了开发工具的调用问题，又不会破坏系统级别的整体安全策略。

六、全文总结与后续配置建议

经过上述步骤，Windows 系统上的 Node.js 与 npm 环境已经处于就绪状态。回顾整个安装过程，核心要素在于：

1. 选对版本：绝大多数场景优先下载偶数主版本的 LTS 稳定版，兼顾兼容性与维护期。
2. 规范向导：保持默认安装路径与“Add to PATH”组件，跳过耗时且通常不必要的原生编译工具安装。
3. 重启验证：安装后新建终端会话，通过 node -v、npm -v 以及单行测试命令完成闭环验证。

当后续需要在项目中安装第三方依赖时，如果遇到网络下载缓慢的情况，可以通过 npm config set registry https://registry.npmmirror.com 切换至国内镜像源；若未来项目涉及在不同的 Node.js 版本之间频繁切换，还可以进一步了解 nvm-windows（Node Version Manager for Windows）多版本切换工具的使用。