webstorm导入本地自建脚手架模板需先打开项目再执行file → save project as template，勾选“include project files”，重启ide后在欢迎页custom templates中可见；模板不执行npm install，需手动安装依赖，且必须提前删除脚手架中的.git目录。
WebStorm 里怎么导入本地自建脚手架模板
不能直接“导入 ZIP”或拖文件进欢迎页——WebStorm 不识别任意压缩包或目录为模板。必须把脚手架内容转成它认可的「项目模板」格式，本质是复制配置 + 文件结构 + 元数据。
关键动作只有两步：File → Export Settings 导出的是 IDE 配置，不是项目模板；真正要用的是 File → Save Project as Template，但该菜单项仅在项目已打开且含有效配置时才可见。
- 先用终端手动初始化一次你的脚手架：比如
cp -r my-scaffold ./my-test-project && cd my-test-project && npm install - 在 WebStorm 中通过
File → Open打开这个my-test-project目录（不是父目录） - 确保项目能正常识别为前端项目（即有
package.json、vite.config.ts或类似配置） - 此时菜单栏才会出现
File → Save Project as Template，点它，填名称如my-vue3-starter，勾选“Include project files”
保存后的模板在哪？新建时怎么选
模板实际存放在 $USER_HOME/.WebStorm2023.3/system/templates（路径随版本微调），但你不需要手动找——新建项目时它会自动出现在欢迎页的“Custom templates”分类下。
常见误操作：保存后立刻关掉项目去新建，结果列表为空。因为 WebStorm 模板缓存是异步加载的，首次使用前需重启 IDE 或等待几秒再点 “New Project”。
- 重启 WebStorm 后，在欢迎页点击
Create New Project - 左侧选择
Custom templates（不是 “Vue.js” 或 “Empty Project”） - 右侧列表中会出现你命名的
my-vue3-starter，选中即可 - 如果没出现，检查
Settings → Appearance & Behavior → System Settings → Templates是否启用 “Show custom templates”
为什么新建项目后 node_modules 没自动安装
WebStorm 的模板机制只复制文件结构和配置，不执行命令。哪怕你模板里写了 "scripts": {"prepare": "npm install"}，新建时也不会触发。
这是设计使然，避免静默执行潜在危险命令。真正的自动化要靠后续动作补全。
- 新建项目后，右下角通常会弹出 “Node.js dependencies detected” 提示，点 “Install” 即可
- 没弹提示？手动打开 Terminal，执行
npm install或yarn - 想省这一步？在模板的
package.json里加一条空的"postinstall": "echo 'ready'"——没用；WebStorm 不监听 postinstall - 真正可靠的方案：用 WebStorm 的 “Run Configuration” 配一个启动前自动运行
yarn的任务，但那是另一个场景了
自建模板里带 .git 的影响
如果你的脚手架目录本身是 Git 仓库（含 .git/ 子目录），Save Project as Template 默认会把它一起打包进去。新建项目时，IDE 会把这个 .git 当作新项目的 Git 根，导致 commit 记录混乱、远程地址错乱。
这不是 bug，是行为一致性的体现：WebStorm 把整个目录当“快照”存下来，包括隐藏文件。
- 保存模板前，务必先删掉脚手架目录下的
.git/文件夹（用rm -rf .git） - 别依赖 IDE 的“忽略隐藏文件”选项——它对模板导出无效
- 如果已经存错了，去
$USER_HOME/.WebStorm*/system/templates找对应 ZIP 解压，删掉.git再重压回去（不推荐，易出错） - 更稳妥的做法：用
git archive --format=zip HEAD > my-template.zip导出干净快照，再手动导入（但 WebStorm 不支持 ZIP 导入，只能退而求其次）
.git 和重启 IDE 等待模板加载——这两步不做，后面所有新建项目都会带着旧仓库痕迹或根本找不到模板。
