Mac终端执行npm start报错“command not found”求助

1. 先确认npm是否已正常安装 #

终端执行以下命令，检查npm本身是否可被系统识别：

npm -v

如果同样返回command not found，说明npm未安装或未加入系统PATH：

• 若Node.js未安装：直接下载对应Mac版本的安装包完成安装，npm会随Node.js自动配置。
• 若Node.js已安装但npm找不到：手动将Node.js的bin目录加入PATH。默认安装路径下，执行：

  echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.zshrc
  

  （使用bash终端则修改~/.bash_profile），执行source ~/.zshrc刷新配置后重启终端。

2. 确认当前目录为项目根目录 #

npm start必须在包含package.json的项目目录下执行，先检查当前目录是否存在该文件：

ls -la | grep package.json

如果没有，要么切换到正确的项目目录，要么执行npm init -y初始化项目，生成基础package.json后再配置启动命令。

3. 检查package.json的start命令配置 #

打开package.json，确认scripts字段中存在start项，示例：

{
  "scripts": {
    "start": "node index.js"
  }
}

若缺失，手动添加对应启动命令后保存，再执行npm start。

4. 修复npm权限或重装npm #

若npm已安装但仍报错，可能是权限异常或npm损坏：

• 修复权限：

  sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}
  

• 重装最新版npm：

  npm install -g npm@latest
  

5. 检查终端shell的PATH配置 #

如果使用zsh，确认~/.zshrc中没有覆盖PATH的错误配置；bash终端则检查~/.bash_profile，确保Node.js的bin目录在PATH列表中。

内容的提问来源于stack exchange，提问作者Aly