npm 或 node 命令找不到怎么办

很多 AI 编程工具或前端项目会用到 Node.js 和 npm。看到 npm 不是内部或外部命令、npm: command not found、node: command not found 时，先判断是不是安装和 PATH 问题。

先别做什么

• 不要先删除项目文件。
• 不要先清空环境变量。
• 不要复制一串修复命令。
• 不要在没确认 Node.js 来源前安装陌生包。

低风险查看命令

这些命令只查看版本，不会修改项目：

node -v
npm -v
where.exe node
where.exe npm

macOS 或 Linux 可以用：

node -v
npm -v
which node
which npm

常见原因

1. 没有安装 Node.js。
2. 安装后没有重启终端。
3. PATH 没有生效。
4. 电脑上有多个 Node.js 版本，当前终端找错位置。
5. 公司或学校电脑限制了环境变量或执行权限。

可复制提示词

我的 npm 或 node 命令找不到。请先帮我判断原因，不要直接让我重装。

系统：{Windows/macOS/Linux}
我运行了这些查看命令：
{粘贴 node -v / npm -v / where 或 which 的结果}

请输出：
1. 最可能原因
2. 下一步只做一个动作
3. 这个动作是否会修改系统
4. 如果需要安装 Node.js，应该去哪个官方入口确认
5. 安装后如何验证成功

成功标志

• node -v 能输出版本号。
• npm -v 能输出版本号。
• 重新打开终端后仍然能识别。

来源与日期

• 来源：Node.js 官方网站。
• 分享日期：2026-06-16。
• 复测日期：2026-06-16。