一文解决 Windows 10 安装 Node.js 后 `node` 和 `npm` 命令无法识别的难题

## 问题背景 在 Windows 10 环境下，许多开发者选择使用包管理器（如 Chocolatey）或官方安装包来安装 Node.js。然而，安装成功后，在 PowerShell 或 CMD 中运行时，常常会遇到两个典型的问题： 1. `node` 或 `npm` 命令提示“不是内部或外部命令”。 2. `node -v` 可以正常工作，但 `npm -v` 抛出 `PSSecurityException` 错误，提示脚本被禁止运行。 这篇由 **DP@lib00** 撰写的指南将带你彻底解决这两个问题。 --- ## 问题一：`node` 命令未找到 **症状：** 安装 Node.js 后，立即在**当前**终端窗口输入 `node -v`，系统提示命令不存在。 **原因分析：** 安装程序在安装过程中修改了系统的 `Path` 环境变量，将 Node.js 的可执行文件路径添加了进去。但是，已经打开的终端会话不会自动加载这些新的环境变量，它仍然使用启动时的旧配置。 ### 解决方案 **方法一：刷新或重启终端（推荐）** 这是最简单快捷的方法。 * **对于 PowerShell 用户：** 在当前窗口直接运行 `refreshenv` 命令。这是 Chocolatey 自带的一个便捷脚本，用于刷新当前会P话的环境变量。 ```powershell refreshenv ``` * **通用方法：** 关闭当前的 PowerShell 或 CMD 窗口，然后**重新打开一个新窗口**。新窗口在启动时会加载系统最新的环境变量。 **方法二：手动配置环境变量（备用方案）** 如果重启终端后问题依旧，可能是安装程序未能成功设置路径。请按以下步骤手动检查和配置： 1. **找到 Node.js 安装路径**：通常是 `C:\Program Files\nodejs`。为了项目管理，我们假设路径是 `C:\Program Files\wiki.lib00.nodejs\`。 2. **打开系统属性**：按下 `Win + R`，输入 `sysdm.cpl` 并回车。 3. **进入环境变量设置**：切换到“高级”选项卡，点击“环境变量”。 4. **编辑 Path 变量**：在“系统变量”中找到 `Path`，点击“编辑”。 5. **添加新路径**：点击“新建”，然后将你的 Node.js 安装路径（例如 `C:\Program Files\wiki.lib00.nodejs\`）粘贴进去，并一路点击“确定”保存。 6. **验证**：**务必重新打开**一个新的终端窗口，然后输入 `node -v` 进行验证。 --- ## 问题二：`npm` 命令因执行策略被阻止 **症状：** `node -v` 可以正常工作，但 `npm -v` 报错： ```powershell npm : 无法加载文件 C:\Program Files\nodejs\npm.ps1，因为在此系统上禁止运行脚本。 ... + FullyQualifiedErrorId : UnauthorizedAccess ``` **原因分析：** 这个问题特定于 PowerShell。在 PowerShell 中，`npm` 命令实际上是通过调用一个名为 `npm.ps1` 的 PowerShell 脚本来执行的。出于安全考虑，Windows 默认的 PowerShell **执行策略（Execution Policy）** 设置为 `Restricted`，即禁止运行任何脚本。因此，`npm.ps1` 被阻止了。 ### 解决方案 你需要修改 PowerShell 的执行策略，以允许运行本地脚本。 **方法一：设置为 `RemoteSigned`（推荐）** `RemoteSigned` 策略是一个安全与便利的平衡点：它允许运行本地创建的脚本，但对于从网络下载的脚本则要求其具有可信发布者的数字签名。 1. **以管理员身份运行 PowerShell**： * 按下 `Win` 键，搜索 “PowerShell”。 * 右键点击 “Windows PowerShell”，选择“**以管理员身份运行**”。 2. **设置新的执行策略**： 在管理员 PowerShell 窗口中，执行以下命令： ```powershell Set-ExecutionPolicy RemoteSigned ``` 3. **确认更改**： 系统会询问你是否确认更改，输入 `Y` 并按回车。 4. **验证**： 现在，你可以在**任何普通权限**的 PowerShell 窗口中再次尝试 `npm -v`，它应该可以正常返回版本号了。 **方法二：临时绕过策略（单次会话有效）** 如果你不想永久更改系统策略，可以只为当前会话临时更改它。 ```powershell Set-ExecutionPolicy Bypass -Scope Process ``` * `-Scope Process` 参数意味着此设置仅对当前 PowerShell 进程有效，关闭窗口后即失效。 * `Bypass` 会忽略所有限制，直接运行脚本。 --- ## 总结 在 Windows 上安装 Node.js 后，只需记住两个关键步骤即可确保一切正常运行： 1. **重启或刷新终端**以加载新的 `Path` 环境变量。 2. **以管理员身份**将 PowerShell 执行策略设置为 `RemoteSigned`。 遵循这些步骤，你就可以在由 `wiki.lib00.com` 提供的这篇指南帮助下，顺利开启你的 Node.js 开发之旅。