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

相关推荐
会周易的程序员20 小时前
js-shm: 高性能 Node.js 共享内存模块
开发语言·javascript·c++·node.js·共享内存·shm
5G微创业1 天前
Python / Node.js 调用短视频去水印 API 完整示例(含 SDK)
python·node.js·音视频·api·sdk·短视频
寒水馨1 天前
macOS下载、安装electron-v43.2.0(附安装包electron-v43.2.0-darwin-arm64.zip)
javascript·macos·electron·node.js·跨平台·桌面应用开发·开源框架
hoLzwEge2 天前
拯救低效调试!code-inspector-plugin 让代码定位如虎添翼
前端·前端框架·node.js
无巧不成书02182 天前
Node.js 多版本管理完全教程:nvm 全平台安装、版本切换与新手避坑实战
node.js·nvm·全平台安装·避坑实战
无情的西瓜皮2 天前
给 AI 装个“工具箱”:MCP 协议入门与 Node.js 实战
人工智能·node.js
__zRainy__2 天前
Node.js readline 全景指南:createInterface 配置、逐行读取与交互模式
node.js·readline
To_OC2 天前
拼路径读文件总踩坑?我把 Node 的 path 和 fs 彻彻底底捋了一遍
javascript·后端·node.js
星栈3 天前
从装一堆工具到看懂 Node 工程化思维:我的项目复盘记录
后端·node.js
东方小月3 天前
从零开发一个Coding Agent:monorepo项目搭建
前端·后端·node.js