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

相关推荐
meilindehuzi_a18 小时前
从零开始:用原生 Node.js 徒手拆解 RAG 与向量检索底层原理
node.js·rag
炒毛豆18 小时前
ai全栈-node.js相关的学习之路(草稿版)
学习·node.js
meilindehuzi_a20 小时前
解密 MCP 协议:如何用 Node.js 从零手写一个本地文件读取 MCP 服务器
运维·服务器·node.js
hoLzwEge4 天前
pnpm vs npm:新一代包管理器的范式革命
前端框架·node.js
麻辣凉茶4 天前
给阿嬤一封来自云端的信(上)
前端·node.js
codingWhat5 天前
能效平台设计方案(打通gitlab和飞书)
后端·node.js·koa
见过夏天7 天前
Node.js 常用命令全攻略
node.js
前端双越老师7 天前
我从 0 开发的 AI Agent 智语项目发布了
前端·node.js·agent
kyriewen8 天前
2026 年了,还在用 Node.js?Bun 迁移实战:20 分钟搞定,附踩坑记录
前端·javascript·node.js
donecoding8 天前
3 条命令搞定闭环 Monorepo:Lerna 版本管理 + 拓扑构建 + 自定义分发
前端·前端框架·node.js