[解决] 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")。

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

Y 是 N 否: 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系列:process配置
前端·node.js
怕浪猫3 天前
ZCode 开源了来看看这是个什么东西
node.js·github·代码规范
flash俊杰4 天前
Electron 打包后窗口 30 秒不出现:一个 ABI 不匹配的血案
electron·node.js
@tangguo1234 天前
npm 和 yarn 配置说明
前端·javascript·npm·node.js·yarn
flash俊杰4 天前
一套代码接入所有大模型:OpenAI 兼容适配器设计
node.js·openai
右耳朵猫AI4 天前
Node.js周刊2026W38 | 进程中断缺陷修复、Copilot 迁至 Rust、Node 新增 VFS
javascript·后端·node.js
光影少年4 天前
Express 中间件原理
后端·node.js·express
时速GEO系统4 天前
初元 AI V1.1 版本升级,首个正式版发布一周・实现生成、部署、上线、优化全流程自动化闭环
人工智能·数据挖掘·node.js
console.log('npc')5 天前
06 — Model 层:数据模型与操作
前端·后端·node.js·express