Vue项目执行npm run serve时开发服务器启动停滞求助

• 检查端口占用
  开发服务器默认使用8080端口，若被其他程序占用会导致启动停滞。Windows下用netstat -ano | findstr :8080、Mac/Linux用lsof -i :8080查看占用进程，杀掉后重试；也可以在vue.config.js中修改端口：

  module.exports = {
    devServer: {
      port: 8081
    }
  }
  

• 排查ESLint问题
  ESLint的严格检查常因代码格式、语法错误卡住启动流程。可以临时在vue.config.js中禁用ESLint：

  module.exports = {
    lintOnSave: false
  }
  

  或者手动执行npm run lint找出并修复所有错误后再启动服务器。

• 修复依赖版本冲突
  部分依赖版本不兼容会引发启动异常。查看package.json中的vue、vue-cli-service等核心依赖版本，尝试降级或升级到稳定兼容版本，例如执行npm install vue-cli-service@~4.5.0安装指定版本。

• 清除npm缓存
  缓存损坏可能导致依赖安装异常，执行npm cache clean --force清除缓存后，重新执行npm install再启动项目。

• 查看详细启动日志
  启动时添加--verbose参数获取完整日志：npm run serve --verbose，根据日志中的错误提示定位具体问题，比如插件加载失败、配置文件语法错误等。

• 尝试切换包管理器
  npm的依赖树解析偶尔会出问题，换成yarn试试：先执行yarn install重新安装依赖，再用yarn serve启动项目。

内容的提问来源于stack exchange，提问作者Harun Doğan