必须用 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 就退化成高级记事本。
