Vue CLI 创建新项目必须用命令行而非 VS Code 新建文件夹,因后者无脚手架能力;需全局安装 @vue/cli,运行 vue create 初始化,再用 VS Code 打开;必装 Volar 插件并禁用 Vetur;默认启动命令为 npm run serve,非 dev。

Vue CLI 创建新项目时为什么不用 VS Code 自带的“新建文件夹”
VS Code 本身只是编辑器,不提供 Vue 项目脚手架能力。直接新建文件夹再手动写 main.js 和 App.vue,大概率会缺 vue-router、vuex(或 pinia)、热更新配置、ESLint 规则,甚至连 npm run dev 都起不来。
正确路径是:用命令行初始化项目,再用 VS Code 打开生成的目录。
- 确保已安装
node(≥16.0)和npm(≥8.0),运行node -v和npm -v确认 - 全局安装 Vue CLI(仅需一次):
npm install -g @vue/cli - 在终端里进入目标父目录,执行:
vue create my-vue-app(my-vue-app换成你想要的文件夹名) - 按提示选择预设(推荐选
Default (Vue 3)快速起步;如需 TypeScript 或 Router,选Manually select features)
VS Code 打开 Vue 项目后哪些插件必须装
没装对插件,.vue 文件里 template/script/style 三块会失去语法高亮、跳转、自动补全,甚至报一堆假错误。
- 必装:
Volar(不是 Vue Language Features (Volar) 的旧版,注意看发布者是johnsoncodehk) - 禁用冲突插件:
Vetur(Vue 2 时代插件,与 Volar 在 Vue 3 项目中严重打架) - 可选但实用:
ESLint(配合项目里已有的.eslintrc.cjs能实时标红不符合规范的代码) - 别碰
Auto Rename Tag类插件——Volar 自带标签自动重命名,开了反而错乱
npm run dev 报错 “command not found” 或页面空白怎么办
常见于初始化后立刻运行,或 package.json 脚本被误删/改名。Vue CLI 默认生成的开发命令是 npm run serve,不是 dev。
立即学习“前端免费学习笔记(深入)”;
- 先检查
package.json里的scripts字段,确认是否存在"serve": "vue-cli-service serve" - 如果只有
"dev"且内容为空或错误,删掉它,保留serve即可 - 首次运行前务必进项目根目录执行
npm install(否则vue-cli-service命令根本不存在) - 终端卡在
Compiled successfully但浏览器打不开?手动访问http://localhost:8080(默认端口,非 3000)
想用 Vite 新建 Vue 项目,和 Vue CLI 有啥实际区别
如果你只是写个小工具、原型或学习,Vite 启动快、配置轻,比 Vue CLI 更直接。但它的“新建”动作依然不在 VS Code 里完成。
- 命令是:
npm create vue@latest(官方推荐,会引导选择 TypeScript、Router、Pinia 等) - 生成后进目录,
npm install→npm run dev(Vite 默认就是dev,不是serve) - Volar 对 Vite 支持良好,但需确保
tsconfig.json中有"compilerOptions": { "types": ["vite/client"] } - 注意:Vite 项目没有
vue.config.js,要用vite.config.ts配置别名、代理等
真正容易被忽略的是:无论用 Vue CLI 还是 Vite,VS Code 都只负责打开和编辑,项目结构、依赖、启动逻辑全靠命令行驱动。点几下鼠标新建文件夹,永远得不到一个可运行的 Vue 应用。










