必须用 npm create vue@latest，因 vue-cli 已停更，create-vue 基于 Vite、支持 Vue 3.4+ 新特性；需 Node.js ≥18.0.0，VS Code 中须装 Volar 并禁用 Vetur。

VSCode 里初始化 Vue 项目，必须用命令行工具，不是插件点一点就能生成的。所谓“在 VSCode 里新建 Vue 项目”，本质是打开它的集成终端，执行官方脚手架命令——npm create vue@latest 是当前唯一推荐、稳定、同步更新的方式。

为什么不用 vue create？

vue create 依赖全局安装的 @vue/cli，而该工具已进入维护模式，不再适配 Vue 3.4+ 的新特性（比如 defineCustomElement 类型推导、ref 在模板中自动解包等）。create-vue 则直接基于 Vite，生成的项目默认启用 defineComponent 类型、shims-vue.d.ts 已预置、vite.config.ts 支持 defineConfig 类型提示——这些在 vue create 生成的老结构里要么缺失，要么要手动补。

• 执行 vue create my-app 后，package.json 里会看到 "vue-cli-service"，但这个包早已不维护，遇到 Cannot find module 'webpack' 或热更新失效时，基本无解
• npm create vue@latest 不需要全局安装，不污染本地环境，每次运行都拉取最新模板（2026 年 5 月最新版已含 vue-router@4.4 + pinia@2.2）
• 如果你误装了 @vue/cli，建议先 npm uninstall -g @vue/cli，避免终端里输 vue 命令时被旧 CLI 拦截

npm create vue@latest 执行失败的常见原因

报错不是命令写错了，而是环境卡在某个隐性环节。最常卡在以下三点：

vue-composition-api-best-practices

Vue 3 组合式 API 与 最佳实践，涵盖代码组织、useXxx 模式、组合式函数设计、Store 集成、响应式优化及功能抽取。

下载

• command not found: npm：VS Code 终端没继承系统 PATH，按 Ctrl+Shift+P → 输入 Terminal: Select Default Profile，选带 Node.js 或 PowerShell 的配置
• Error: Cannot find module 'create-vue'：Node 版本太低，npm create 要求 Node ≥ 18.0.0，运行 node -v 确认，低于 v18.17 建议升级
• 交互式选项卡住不动（光标闪但没提示）：终端编码或代理干扰，临时关掉公司代理、禁用 cnpm/pnpm 镜像源，改用 npm config set registry https://registry.npmjs.org/

执行完命令后，VSCode 里必须立刻做的三件事

项目文件夹生成完毕，别急着写代码。有三个动作不做，后续 90% 的类型提示、跳转、断点都会失效：

• 在 VS Code 扩展市场搜 Volar 安装（不是 Vetur），并确认设置里 "volar.takeOverMode": true 已启用
• 再装一个配套插件：TypeScript Vue Plugin (Volar)——它专管 .vue 文件里的 TS 类型，缺了就 ref 不推导、defineProps 报红
• 如果之前装过 Vetur，必须彻底禁用：进 VS Code 设置搜 vetur，把 Vetur: Enable 取消勾选，否则 <template></template> 里 v-model 会持续报错

真正麻烦的从来不是命令输错，而是以为“项目建好了”就完事——其实刚起步，node_modules 是否完整、Volar 是否接管、tsconfig.json 是否被正确识别，这三个点任何一个出问题，VS Code 就退化成高级记事本。

前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！