React项目执行npm start报错：'react-scripts'不是内部或外部命令

之前项目运行一切正常，拉取Git仓库更新后执行npm start时出现报错：'react-scripts'不是内部或外部命令、可执行程序或批处理文件。已尝试直接安装react-scripts、升级Node.js至19.7.0、更新包管理器、删除node_modules后重新执行npm install，但问题仍未解决。项目的package.json配置如下：

{
  "name": "name",
  "version": "0.1.0",
  "private": true,
  "dependencies": {
    "@testing-library/jest-dom": "^5.16.5",
    "@testing-library/react": "^13.4.0",
    "@testing-library/user-event": "^13.5.0",
    "axios": "^1.3.4",
    "react": "^18.2.0",
    "react-dom": "^18.2.0",
    "react-router-dom": "^5.2.1",
    "react-scripts": "5.0.1",
    "web-vitals": "^2.1.4"
  },
  "scripts": {
    "start": "react-scripts start",
    "build": "react-scripts build",
    "test": "react-scripts test",
    "eject": "react-scripts eject",
    "tailwind-config-viewer": "tailwind-config-viewer -o"
  },
  "eslintConfig": {
    "extends": [
      "react-app",
      "react-app/jest"
    ]
  },
  "browserslist": {
    "production": [
      ">0.2%",
      "not dead",
      "not op_mini all"
    ],
    "development": [
      "last 1 chrome version",
      "last 1 firefox version",
      "last 1 safari version"
    ]
  },
  "devDependencies": {
    "autoprefixer": "^10.4.13",
    "postcss": "^8.4.21",
    "tailwind-config-viewer": "^1.7.2",
    "tailwindcss": "^3.2.7",
    "typescript": "^4.9.5"
  }
}

排查与解决步骤 #

• 清理npm缓存后重装依赖：
  执行npm cache clean --force，然后删除项目根目录下的node_modules文件夹和package-lock.json文件，再重新运行npm install

• 手动指定版本安装react-scripts：
  执行npm install react-scripts@5.0.1 --save，确保依赖完全安装到本地

• 修改脚本使用npx调用：
  把package.json里的start脚本改成"start": "npx react-scripts start"，再执行npm start

• 直接调用本地react-scripts：
  执行./node_modules/.bin/react-scripts start，绕开环境变量的问题

• 检查Git忽略配置：
  查看.gitignore文件，确认没有错误忽略node_modules/.bin或react-scripts相关文件，避免拉取更新后依赖缺失

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