[解决] 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 才能生效。

相关推荐
烂蜻蜓3 分钟前
Node.js入门教程(二十三):全局对象
node.js·编辑器·vim
xywww1686 小时前
Node.js Claude API 实战接入:SDK 调用 Opus 5、环境变量配置与报错排查
node.js
weixin_431600447 小时前
NestJS 入门(7):生命周期钩子——构造函数和 `OnModuleInit` 差在哪?
前端·后端·学习·node.js·nest.js
深念Y7 小时前
基于 NapCat 与本地 RAG 的群聊 AI 机器人方案(ARM64 部署)
人工智能·ai·机器人·node.js·自动化·情感陪伴·bot
__zRainy__8 小时前
Node系列 · Node基础:Node.js 概述
后端·node.js
烂蜻蜓8 小时前
Node.js入门教程(二十四):常用工具(util 模块)
node.js
oushaojun29 小时前
使用docker安装node.js和deepseek harness
node.js·dsh
爱丶不疚10 小时前
搞不清 CommonJS 与 ESM,你是否也有这些疑问🤔
前端·node.js
cyadyx13 小时前
Vite 比 Webpack 构建效率更高
前端·webpack·node.js·vite
烂蜻蜓1 天前
Node.js入门教程(十一):异步编程
node.js