导出 fileTemplates 必须手动勾选 Export Settings 中的对应项，否则自定义模板丢失；迁移可直接复制 templates 目录下的 fileTemplates.xml；JSON 模板需转为合法 XML 并打包 JAR 导入；模板生效还需在 Files 选项卡中正确绑定文件类型。
导出 fileTemplates 必须勾选 Export Settings 中的对应项
PhpStorm 的 fileTemplates 不会随「全选导出」自动包含，GUI 导出界面默认不勾选它。漏掉这一项，你精心配置的 PHP 类模板、Blade 文件头、Test stub 等全部丢失，新建文件时退回空骨架。
操作时务必在 Export Settings… 对话框中手动勾选：fileTemplates——其他如 liveTemplates、colors、inspectionProfiles 也同理，但这里只聚焦文件模板。
常见错误现象：
- 导出后在新机器上新建
.php文件，没看到自定义版权注释或命名空间结构 - Settings → Editor → File and Code Templates 页面里，User-defined 模板列表为空
原因几乎总是：导出时没勾选 fileTemplates，或者导出路径含中文/空格（导致 XML 解析失败，静默丢弃）。
立即学习“PHP免费学习笔记（深入）”；
直接复制 templates 目录更轻量、更可控
如果你只关心迁移 fileTemplates，且已有同事给的配置，跳过 GUI 更快：
- Linux/macOS 路径：
~/.config/JetBrains/PhpStorm2025.1/config/templates/ - Windows 路径：
%USERPROFILE%\.PhpStorm2025.1\config\templates\ - 把目标
fileTemplates.xml放进该目录，覆盖原文件 - 重启 PhpStorm，进
Settings → Editor → File and Code Templates查看是否生效
注意：fileTemplates.xml 是纯文本，可 git 版本管理；但不要手动编辑它——IDE 启动时会校验格式，错一个标签就整个文件失效，模板全退回到默认。
导入 JSON 格式文件模板需绕过 PhpStorm 的限制
部分团队用 JSON 统一管理模板（如 php-templates.json），但 PhpStorm 原生不支持直接导入 JSON 文件模板。它只认 XML 结构，且必须通过 GUI 导入设置包（JAR）才能加载。
若坚持用 JSON 流程，唯一可行路径是：
- 确保 JSON 内容已由工具（如 JetBrains 官方 converter 或社区脚本）转为合法 XML 格式
- XML 必须包含
<template>根节点，每个子项含name、value、reformat、liveTemplate等字段 - 将该 XML 打包进 JAR，并在
Import Settings中勾选fileTemplates才能识别
别试图把 JSON 文件拖进 Settings 页面——界面会接受，但不会解析，也不会报错，只是静默忽略。
fileTemplates 生效依赖上下文匹配
即使 XML 文件正确、导入成功、模板显示在列表里，它仍可能不触发。关键在「上下文绑定」：
- 打开
Settings → Editor → File and Code Templates - 选中你的模板（比如
PHP Class），右侧的Files选项卡下，必须勾选PHP（大小写敏感） - 如果勾的是
HTML或留空，新建.php文件时它就不会被调用
这个动作不会自动发生，也没有提示。很多人以为“导入了=能用”，结果新建文件还是空的——问题就卡在这一步。
