应导出为 phpstorm-file-templates.xml 并存入项目 config/ 目录，成员复制到对应系统配置路径后重启 IDE；$NAMESPACE$ 为空需标记 Sources Root；Interface/Trait 需单独建模板；File Templates 与 Live Templates 变量不互通。
怎么把 File Templates 同步给团队成员
直接提交 .idea/fileTemplates/ 目录不可靠——它依赖 IDE 配置路径、用户目录变量（如 $USER$）和本地文件系统结构，跨平台或不同 PhpStorm 版本下容易失效。真正可共享的是模板内容本身，不是 IDE 自动生成的缓存路径。
正确做法是把模板导出为纯文本 XML 文件，由团队统一维护在项目仓库中：
- 在 Settings → Editor → File and Code Templates → Files 标签页，点击右上角齿轮图标 → Export
- 保存为
phpstorm-file-templates.xml，放入项目根目录下的.phpstorm/或config/子目录（不进.idea/） - 在
.gitignore中确保排除.idea/fileTemplates/和.idea/misc.xml（后者可能硬编码绝对路径） - 提供简短说明文档，告诉成员：关闭 PhpStorm → 将该 XML 文件复制到本地配置目录对应位置 → 重启 IDE
本地配置路径示例：
Windows：%USERPROFILE%\.PhpStorm2026.2\config\fileTemplates\
macOS：~/Library/Caches/JetBrains/PhpStorm2026.2/fileTemplates/
Linux：~/.cache/JetBrains/PhpStorm2026.2/fileTemplates/
为什么 PHP Class 模板里 $NAMESPACE$ 总是空的
这不是模板写错了，而是 PhpStorm 不会自动推导命名空间——它只在你把目录标记为 Sources Root 后，才根据目录层级展开 $NAMESPACE$ 变量。没标记就永远是空字符串，哪怕你写了 #parse("PHP File Header.php") 也无效。
- 右键项目中存放类的目录（如
src/）→ Mark Directory as → Sources Root - 确认该目录图标变成蓝色小圆点，且路径出现在 Project Settings → Directories 页面中
- 如果用了 PSR-4 自动加载，但
src/下还有子目录（如src/Domain/），则$NAMESPACE$会自动拼成Domain，无需手动写死 - 改完必须重启 PhpStorm，否则缓存仍输出原始变量名（例如显示为
$NAMESPACE$而非真实值）
Live Template 和 File Template 混用时变量不生效
两者变量系统完全隔离：$NAME$、$DATE$ 这类只在 File Templates（新建文件时）生效；而 $SELECTION$、$METHOD_NAME$ 是 Live Templates（代码编辑中 Tab 展开）专用。误把后者塞进 File Template，结果就是原样输出文字。
立即学习“PHP免费学习笔记（深入）”；
- File Templates 支持的变量只有：
$PROJECT_NAME$、$FILE_NAME$、$NAME$、$NAMESPACE$、$DATE$、$TIME$等，完整列表见 Settings → Editor → File and Code Templates → Help 图标 -
#parse("xxx")只能引用同在Files分类下的其他模板，不能跨到Includes或Live Templates - 想在类里插入当前日期？用
$DATE$；想插入光标选中的代码块？那是 Live Template 的事，别混进文件模板
如何让新创建的 Interface/Trait 自动带正确关键字
PhpStorm 默认没有为 interface 或 trait 提供独立模板，它们全被归到 “PHP Class” 模板里，所以新建 UserRepositoryInterface 时生成的是 class UserRepositoryInterface，语义错误。
- 进入 Settings → Editor → File and Code Templates → Files，点击 + → Template
- 名称填
PHP Interface，扩展名填php，正文写：/** * @package $NAMESPACE$ */ interface $NAME$ { } - 同理新建
PHP Trait模板，正文为：trait $NAME$ { } - 删掉默认模板里所有
extends \Exception、implements这类只适用于 class 的语法残留 - 注意：
$CLASS_NAME$是旧版变量，已弃用，一律用$NAME$
最易忽略的一点：改完模板不重启 IDE，改动不会生效——变量不解析、关键字不替换、命名空间仍是空，不是 bug，是缓存机制。
