Vue项目执行npm run serve提示Missing script: serve报错如何解决

AI 小北

2026-8-28

报错核心原因

执行npm run 脚本名时，npm会读取当前目录下package.json里的scripts字段匹配对应命令，出现Missing script: "serve"就是没在当前执行环境找到名为serve的脚本配置，按以下顺序排查即可：

排查解决步骤

第一步：校验当前命令执行路径
执行命令时必须处于项目根目录（也就是当初执行项目初始化、npm install安装依赖的目录，不是src子文件夹，也不是项目外层的存放目录）。Windows环境下直接执行cd即可查看当前路径，Mac/Linux执行pwd查看，路径不对就切到正确的项目根目录再重试命令。
第二步：核对package.json的脚本配置
打开项目根目录下的package.json文件，找到scripts字段，对照自己的项目脚手架类型判断：
如果是Vite创建的Vue3项目，默认没有serve启动脚本，启动命令为npm run dev，对应默认脚本配置如下：
```
{
  "scripts": {
    "dev": "vite",
    "build": "vite build",
    "preview": "vite preview"
  }
}
```
如果是Vue CLI创建的项目，scripts下应该存在serve配置，对应配置如下，如果缺失手动补上即可：
```
{
  "scripts": {
    "serve": "vue-cli-service serve",
    "build": "vue-cli-service build",
    "lint": "vue-cli-service lint"
  }
}
```
第三步：修复依赖损坏问题
如果路径正确、脚本配置也存在，大概率是依赖安装不全或缓存损坏：先删除项目根目录下的node_modules文件夹和package-lock.json文件，重新执行npm install安装全部依赖，安装完成后再执行启动命令。
第四步：补全项目初始化流程
如果只是单独执行了npm install vue bootstrap安装依赖，没有通过Vue脚手架初始化项目结构，项目本身不会自带serve/dev这类启动脚本：先执行npm create vue@latest按提示完成项目初始化，进入生成的项目文件夹重新安装依赖后，再执行对应启动命令即可。