vue create 命令初始化项目最稳妥,需全局安装@vue/cli、终端执行、手动选特性、cd后code .打开,并装Volar而非Vetur;Node建议16.14+/18.12+,禁用代理和cnpm/pnpm,注意vue create(Webpack)与create-vue(Vite)区别。

用 vue create 命令初始化项目(别手建文件夹)
VS Code 本身不创建 Vue 项目,它只是编辑器。真正新建项目的动作发生在终端里,靠的是 Vue CLI。如果你在 VS Code 里手动新建文件夹、再一个个补 package.json、main.js、App.vue,大概率缺依赖、路径错、版本不兼容——尤其是 Vue 3 的 createApp 和 Vue 2 的 new Vue 混用时,控制台第一行就报 TypeError: Cannot read property 'use' of undefined。
- 确保已全局安装 Vue CLI:
npm install -g @vue/cli(注意不是vue-cli,旧包名早已废弃) - 在终端中进入目标父目录,运行:
vue create my-project - 选“Manually select features”比“Default (Vue 3)”更稳妥——比如你明确要 TypeScript + Router + Pinia,就勾上,避免后续反复
vue add引发插件冲突 - 创建完别急着开 VS Code:先
cd my-project,再code .(这样工作区才带完整配置,否则 ESLint、Vetur 或 Volar 可能读不到vue.config.js或tsconfig.json)
VS Code 打开项目前必须装对扩展(Volar 不是可选项)
Vue 3 项目里继续用 Vetur 会出离奇问题:模板里 v-model 报红、defineProps 提示“cannot find name”,甚至 ref 类型推导完全失效。这是因为 Vetur 已停止维护,不支持组合式 API 的类型解析。
- 卸载 Vetur(如果装了)
- 安装
Volar(官方推荐)和TypeScript Vue Plugin (Volar)(必须一起装,否则.vue里的 TS 代码不校验) - 在 VS Code 设置里搜
experimental.autoInsertPragma,关掉它——否则保存时自动加/*<em> @jsxRuntime classic </em>/,和 Vue 3 的 JSX 配置打架 - 如果项目是 Vue 2,反而要禁用 Volar、启用 Vetur,并确认
vetur.validation.template是 true
vue create 后 npm run serve 启动失败?检查 Node 版本和代理
常见报错是 Error: Cannot find module '@vue/cli-service' 或 ERR_OSSL_PEM_ROUTINE,表面是依赖问题,根因往往在环境。
- 运行
node -v确认是 16.14+ 或 18.12+(Vue CLI 5 要求 Node ≥ 14.17,但实际用 16/18 最稳;Node 20 某些 patch 版有 crypto 兼容问题) - 如果公司网络走代理,
npm config get proxy查是否残留旧代理配置,有就npm config delete proxy && npm config delete https-proxy - 不要用
cnpm或pnpm初始化项目——vue create内部调用的是 npm,混用会导致node_modules结构异常,后续vue add router直接卡住 - 启动前先
npm install(即使vue create声称已装),再npm run serve
Vue CLI 的脚手架逻辑藏得深,比如 vue create 实际生成的是基于 webpack 的构建,而 create-vue(npm create vue@latest)才是 Vite 默认方案。选哪个取决于你要不要热更新速度或 Webpack 细粒度配置——这点容易被忽略,但一旦项目跑起来再换构建工具,成本远高于初始化时多敲一条命令。
立即学习“前端免费学习笔记(深入)”;









