VSCode本身不运行Vue项目，仅提供编辑和终端环境；真正启动服务的是npm run执行的脚本，依赖Node.js环境、完整node_modules及package.json中正确的scripts定义。
VSCode 本身不运行 Vue 项目，它只是个编辑器；真正启动服务的是 npm run 执行的脚本，而能否跑起来，取决于 Node.js、依赖、脚本名三者是否对得上。
确认 Node.js 和 npm 已就位且版本可用
终端里输 node -v 和 npm -v 必须能立刻返回版本号（2026 年推荐 Node.js v18.17+ 或 v20.9+）。如果报错 'node' 不是内部或外部命令，说明系统 PATH 没配好——Windows 用户尤其要检查环境变量中是否包含 C:\Program Files\nodejs；macOS/Linux 用户可尝试重装 Node.js 或用 which node 确认路径。
常见坑点：
- VSCode 终端有时继承了错误的 shell 配置，按
Ctrl+Shift+P→ 输入Terminal: Select Default Profile，选带 “Node.js” 或 “PowerShell” 的配置更稳妥 - 某些公司电脑禁用了 PowerShell 脚本执行策略，临时切到
cmd终端能绕过ExecutionPolicy报错
必须看 package.json 的 scripts 字段，别凭经验输命令
Vue CLI 项目默认是 "serve": "vue-cli-service serve"，Vite 项目默认是 "dev": "vite"。输错脚本名会直接报 ERR! Missing script: "dev" 或 Missing script: "serve"。
立即学习“前端免费学习笔记（深入）”；
实操建议：
- 打开项目根目录下的
package.json，眼睛盯住scripts对象，复制粘贴比手敲更安全 - 大小写敏感：
npm run Serve❌，npm run serve✅ - 不能漏掉
run：npm serve❌，npm run serve✅ - 老项目可能用
"start": "vue-cli-service serve"，那就得执行npm start
node_modules 缺失或损坏，npm run 就必然失败
终端显示 Cannot find module 'vite' 或 command not found: vue-cli-service，90% 是因为 node_modules 文件夹不存在、为空，或安装中途被中断。
解决步骤：
- 先用
ls -la（macOS/Linux）或dir（Windows）确认当前目录下有package.json和非空的node_modules - 没有？执行
npm install（或yarn install/pnpm install），等进度条走完 - 装完仍报错？删掉
node_modules和package-lock.json，再重装一次 - 临时排查可用
npx vue-cli-service serve（Vue CLI）或npx vite（Vite），但不能替代本地安装
终端输出 Compiled successfully ≠ 服务已可访问
构建成功只代表代码打包完了，真正要看的是日志末尾的监听地址，比如 Local: http://localhost:5173/（Vite）或 Local: http://localhost:8080/（Vue CLI）。如果浏览器打不开，优先查这几件事：
- 端口被占：Linux/macOS 用
lsof -i :5173，Windows 用netstat -ano | findstr :5173找 PID 后kill -9 PID或taskkill /PID PID /F - 临时换端口：加双横线参数，如
npm run dev -- --port 3001（注意--不能少，否则参数传不进 vite） - 页面空白：打开浏览器 Network 标签页，看
index.html是否返回 200，.js文件是否 404——大概率是 Vite 的base配置写成了'./'，开发时应保持默认或设为'/'
最常被忽略的一点：VSCode 内置终端默认打开位置未必是你的项目根目录，每次执行前务必用 pwd 或 cd 确认路径，否则 npm install 和 npm run serve 全都白干。
