[解决] Node.js 安装后 命令找不到

user

我在windows的powershell执行了winget install OpenJS.NodeJS.LTS安装完成后,继续执行报错

node -v

npm -v

PS C:\Users\xx> winget install OpenJS.NodeJS.LTS

"msstore"源要求在使用前查看以下协议。

Terms of Transaction: https://aka.ms/microsoft-store-terms-of-transaction

源要求将当前计算机的 2 个字母的地理区域发送到后端服务才能正常工作,(例如"US")。

是否同意所有源协议条款?

YN 否: y

已找到 Node.js (LTS) OpenJS.NodeJS.LTS 版本 24.16.0

此应用程序由其所有者授权给你。

Microsoft 对第三方程序包概不负责,也不向第三方程序包授予任何许可证。

正在下载 https://nodejs.org/dist/v24.16.0/node-v24.16.0-x64.msi

██████████████████████████████ 31.3 MB / 31.3 MB

已成功验证安装程序哈希

正在启动程序包安装...

安装程序将请求以管理员身份运行。期待提示。

已成功安装

PS C:\Users\xx> node -v

node : 无法将"node"项识别为 cmdlet、函数、脚本文件或可运行程序的名称。请检查名称的拼写,如果包括路径,请确保路径正确

,然后再试一次。

所在位置 行:1 字符: 1

  • node -v

  • ~~~~

  • CategoryInfo : ObjectNotFound: (node:String) \[\], CommandNotFoundException

  • FullyQualifiedErrorId : CommandNotFoundException

PS C:\Users\xx> npm -v

npm : 无法将"npm"项识别为 cmdlet、函数、脚本文件或可运行程序的名称。请检查名称的拼写,如果包括路径,请确保路径正确,

然后再试一次。

所在位置 行:1 字符: 1

  • npm -v

  • ~~~

  • CategoryInfo : ObjectNotFound: (npm:String) \[\], CommandNotFoundException

  • FullyQualifiedErrorId : CommandNotFoundException

ChatGPT

你遇到的问题是典型的 Node.js 安装成功但命令未识别 的情况,这通常和 系统 PATH 环境变量 有关。PowerShell 无法找到 node 和 npm,说明安装的路径没有添加到系统的环境变量里。下面我帮你一步步排查和解决:

1️⃣ 确认 Node.js 安装目录

用 winget 安装 LTS 版本,默认会安装在:

代码C:\Program Files\nodejs\

请先确认该目录是否存在 node.exe 和 npm.cmd。可以在 PowerShell 中执行:

PowerShellGet-ChildItem "C:\Program Files\nodejs\"

如果能看到 node.exe 和 npm.cmd,说明安装没问题,只是路径没加。

2️⃣ 检查 PATH 环境变量

在 PowerShell 中运行:

PowerShell$env:Path -split ';'

查看是否包含:

代码C:\Program Files\nodejs\

如果没有,就需要手动添加。

3️⃣ 临时添加到 PATH(PowerShell 会话有效)

PowerShell$env:Path += ";C:\Program Files\nodejs\"

然后再执行:

PowerShellnode -vnpm -v

如果成功显示版本号,说明问题确实是 PATH。

4️⃣ 永久添加到系统 PATH

打开 开始菜单 → 环境变量 → 编辑系统环境变量 → 高级 → 环境变量

在 系统变量 中找到 Path → 编辑 → 新建 → 输入:

代码C:\Program Files\nodejs\

点击 确定 保存

关闭并重新打开 PowerShell(重要,必须新开)

再次执行:

PowerShellnode -vnpm -v

正常情况下就会显示 Node.js 和 npm 版本。

5️⃣ 如果仍然不行

确保没有安装过其他 Node.js 版本干扰。

可以尝试使用 winget uninstall OpenJS.NodeJS.LTS 卸载后重新安装。

确认你安装的是 管理员权限,有时权限问题会导致路径未写入注册表。

💡 小提示:

PowerShell 对新 PATH 更新敏感,修改环境变量后必须重新打开 PowerShell 才能生效。

相关推荐
孜孜不倦不忘初心4 小时前
mac安装nvm及问题记录
前端·node.js
快乐的哈士奇8 小时前
Gmail-邮件自动处理系统
node.js·自动化·excel
星空10 小时前
Node.js (Express) + Vue2 Axios 前后端交互 CRUD
vue.js·node.js·express
云浪11 小时前
别再让用户干等了:用 Express + SSE 实现《红楼梦》AI 问答实时输出
javascript·后端·node.js
怕浪猫11 小时前
Electron 开发实战(十四):实战项目|从零搭建轻量化桌面代码编辑器
前端·electron·node.js
zhuxiaojt1 天前
npx 为何如此之慢?浅谈 npx 速度慢的原因及工具推荐
node.js
码农刚子1 天前
从零开始:在 Windows 服务器上部署 Node.js 项目(小白实战教程)
后端·node.js
MageGojo1 天前
用 Node.js 把聚合 API 平台封装成零依赖命令行工具:registry 驱动的工程实践
node.js·restful·api接口·命令行工具·cli
濮水大叔1 天前
浅论CabloyJS全栈框架提供的“两级页签”机制
typescript·node.js·next.js