运行npm run dev时报错Missing script 'dev'的求助

开发者阿泽

2026-7-15

解决npm run dev提示“Missing script: 'dev'”的问题（package.json已配置dev脚本）

执行npm run dev时触发如下错误，尽管package.json的scripts字段已明确配置"dev": "vite"，且确认命令输入正确、依赖已通过npm i完成安装，问题仍未解决。

我的package.json内容：

{
  "name": "vite-project",
  "private": true,
  "version": "0.0.0",
  "type": "module",
  "scripts": {
    "dev": "vite",
    "build": "vite build",
    "lint": "eslint src --ext js,jsx --report-unused-disable-directives --max-warnings 0",
    "preview": "vite preview"
  },
  "dependencies": {
    "@reduxjs/toolkit":"^1.9.1",
    "axios":"^1.2.2",
    "dayjs":"^1.11.7",
    "react": "^18.2.0",
    "react-circular-progressbar":"^2.1.0",
    "react-dom": "^18.2.0",
    "react-icons": "^4.7.1",
    "react-infinite-scroll-component":"^6.1.0",
    "react-lazy-load-image-component":"^1.5.6",
    "react-player":"^2.11.0",
    "react-redux":"^8.0.5",
    "react-router-dom":"^6.6.2",
    "react-select":"^5.7.0",
    "sass":"^1.57.1"
  },
  "devDependencies": {
    "@types/react": "^18.2.14",
    "@types/react-dom": "^18.2.6",
    "@vitejs/plugin-react": "^4.0.1",
    "eslint": "^8.44.0",
    "eslint-plugin-react": "^7.32.2",
    "eslint-plugin-react-hooks": "^4.6.0",
    "eslint-plugin-react-refresh": "^0.4.1",
    "vite": "^4.4.0"
  }
}

错误信息：

npm ERR! Missing script: "dev"
npm ERR!
npm ERR! To see a list of scripts, run:
npm ERR!   npm run

npm ERR! A complete log of this run can be found in: C:\Users\lodhi\AppData\Local\npm-cache\_logs\2023-07-18T22_58_14_424Z-debug-0.log

以下是可落地的排查与解决方法：

确认终端当前目录：执行cd（Windows）或pwd（Mac/Linux），检查是否处于package.json所在的项目根目录。多数情况下是终端路径不对，导致npm找不到正确的配置文件。
清除缓存并重装依赖：
1. 执行npm cache clean --force清除npm缓存
2. 删除项目根目录下的node_modules文件夹和package-lock.json文件
3. 重新执行npm install安装依赖
检查npm版本兼容性：部分npm版本与项目依赖存在冲突，执行npm -v查看当前版本。可尝试升级到最新稳定版：npm install -g npm@latest，或降级到npm 8.x版本测试。
校验package.json语法：看似正常的配置可能存在隐藏的JSON语法错误（如漏写逗号、引号不匹配）。执行npm run查看实际可识别的脚本列表，如果输出中没有dev，说明JSON解析异常，手动检查或用本地JSON校验工具排查问题。
检查版本管理工具环境：若使用nvm、nvs等Node版本管理工具，确认终端当前使用的Node/npm版本与项目适配。执行where npm（Windows）或which npm（Mac/Linux）查看路径，确保环境一致性。

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