Vue.js中npm run dev无报错但无法启动本地服务求助

排查与修复步骤： #

1. 重置依赖环境 #

• 删除项目根目录下的node_modules文件夹
• 删除package-lock.json文件
• 执行npm install重新安装所有依赖
• 再次运行npm run dev测试

2. 排查Vite配置问题 #

• 检查项目根目录的vite.config.js（或.ts）文件，确认是否存在错误配置（如插件冲突、路径别名错误）
• 若没有配置文件，创建最简配置文件测试：

import { defineConfig } from 'vite'
import vue from '@vitejs/plugin-vue'

export default defineConfig({
  plugins: [vue()]
})

• 尝试指定端口启动：vite --port 3001，避免默认端口5173被占用未触发报错

3. 检查端口占用 #

• Windows终端执行netstat -ano | findstr :5173，查看是否有进程占用Vite默认端口
• 若存在占用，在任务管理器中找到对应PID的进程并关闭，再重启服务

4. 移除冲突依赖 #

你的package.json中包含vue-cli@2.9.6，这是Vue 2时代的旧工具，与Vite存在兼容性冲突：

• 执行npm uninstall vue-cli移除该依赖
• 重新执行npm install和npm run dev

5. 调整Vite版本 #

当前Vite 5.0.10可能存在兼容性问题，尝试切换版本：

• 降级到Vite 4.x稳定版：npm install vite@4.5.2 -D
• 或升级到最新稳定版：npm install vite@latest -D
• 重启服务测试

6. 检查终端与路径 #

• 以管理员身份运行终端（Windows），避免权限不足导致进程无法启动
• 将项目移动到无特殊字符（空格、中文）的路径下，比如D:\projects\smart-z-calc，再尝试启动

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