npm: command not found

一句话：终端提示找不到npm命令，通常表示Node.js没安装、PATH没配置或终端没有重新加载环境变量。

它是什么

npm: command not found 是一个常见开发环境报错。它说明系统当前找不到npm这个命令，不一定是项目代码错了，更多时候是Node.js安装、版本管理器或环境变量路径的问题。

适合干什么

• 第一次运行前端项目的人
• 安装Node.js后仍然无法执行npm的人
• macOS、Linux或WSL用户
• 从GitHub下载项目但跑不起来的人

不适合干什么

• 项目已经能正常执行npm但构建失败的情况
• pnpm或yarn自身的依赖报错
• 服务器生产环境紧急故障直接照抄命令

普通人怎么用

• 先执行 node -v
• 再执行 npm -v
• 如果都找不到，安装Node.js LTS
• 安装后关闭并重新打开终端
• 回到项目目录重新执行npm命令

进阶用户怎么用

• 使用nvm管理Node版本
• 检查which npm或where npm输出
• 确认PATH包含Node安装目录
• 不同项目用.nvmrc锁定版本

常见误区

• 在浏览器里搜索随机命令乱装
• 安装了Node但没重启终端
• 把npm问题误判为项目代码问题
• 同时安装多个Node版本导致路径混乱

和相似工具的区别

• npm not found vs npm install failed：npm not found是系统找不到命令，npm install failed是找到了npm但安装依赖失败。
• npm vs npx：npm主要管理依赖和脚本，npx常用来临时执行包里的命令。

入门步骤

• 检查node -v
• 检查npm -v
• 安装或修复Node
• 重启终端
• 进入项目目录运行npm install

推荐工具（第三方）

Node.js、nvm、VS Code、Terminal、ChatGPT