应选 npx create-vue(推荐),这是 Vue 官方主推的脚手架,生成 Vue 3 + Vite 项目,预装 TypeScript、ESLint 等现代配置;@vue/cli 已进入维护模式,新项目不建议使用。

WebStorm 里选 Vue.js 模板时,create-vue 和 @vue/cli 该选哪个
直接选 npx create-vue(推荐)。这是 Vue 官方当前主推的脚手架,生成的是 Vue 3 + Vite 项目,默认带 TypeScript、ESLint、Prettier、测试工具等现代配置。而 @vue/cli 默认生成的是 Vue 2 或 Webpack 构建的 Vue 3 项目,已进入维护模式,新项目不建议用。
如果你在下拉菜单里只看到 @vue/cli 选项,说明 WebStorm 没识别到本地 Node.js 环境或 npm 版本过低(低于 8.0)。检查 Node Interpreter 字段是否指向有效的 node 可执行文件;若为空,点 Add 手动指定路径(常见位置:/usr/local/bin/node macOS/Linux,C:\Program Files\nodejs\node.exe Windows)。
点击 Create 后卡在 “Installing dependencies” 或报错 ENOTEMPTY
这通常是因为目标文件夹非空,或权限不足。WebStorm 不会自动清空已有目录,哪怕只是残留一个 .git 或 package-lock.json 都可能触发失败。
- 务必新建一个**完全空白**的文件夹(如
/Users/you/projects/my-vue-app),不要复用旧项目目录 - 确认该文件夹父级目录有写入权限(macOS/Linux 下避免放在
/System或根目录;Windows 下避开受保护的Program Files) - 如果终端报
npm ERR! code ENOTEMPTY,手动删掉目标文件夹再重试 - 国内用户若卡在依赖下载,可在 WebStorm 终端(
Alt+F12)提前运行:npm config set registry https://registry.npmmirror.com
项目生成后,npm run dev 启动失败,提示 command not found: vite
说明依赖没装全,或者 WebStorm 没正确识别 package.json 中的 scripts。Vite 项目默认用 npm run dev(实际执行 vite),不是 npm run serve。
立即学习“前端免费学习笔记(深入)”;
先验证:在 WebStorm 终端中执行 ls node_modules/.bin/vite,若有输出说明 vite 已安装;若无,运行 npm install 手动补装。
更稳妥的启动方式是用 WebStorm 内置的 npm 配置:
- 右上角点击
Add Configuration→+ → npm -
Package.json选项目根目录下的package.json -
Command填run,Scripts下拉选dev - 勾选
Run npm install automatically before running this script
这样每次点击绿色三角就能确保依赖就绪后再启动。
创建完项目,想加个 HelloWorld.vue 组件但 WebStorm 不识别语法高亮
不是文件问题,是插件没开。Vue 文件支持依赖 IDE 的 Vue.js 插件,它默认启用,但偶尔会被禁用或加载失败。
进 Settings | Plugins(macOS 是 Preferences | Plugins),搜索 Vue.js,确认状态为 Enabled。如果灰色不可点,重启 WebStorm;如果列表里压根没有,点右上角 Marketplace 搜索安装。
另外注意:组件文件必须放在 src/components/ 或类似逻辑目录下(而非根目录),否则 WebStorm 可能不触发 Vue 专属代码补全(比如 <script setup> 语法、defineProps 提示)。
新建文件时,右键目录 → New → File,输入 HelloWorld.vue 即可,无需额外模板——WebStorm 会自动套用 Vue 文件模板(含基本结构)。


















