live templates 无法直接导出为文件,须通过 export settings(需勾选 livetemplates、filetemplates、colors、inspectionprofiles 并取消 cache/system/plugins)或替换 config/livetemplates.xml 文件实现;json 导入需格式合规且手动启用 php 上下文。

Live Templates 不能直接“导出为文件”供他人一键导入,必须走 Settings 导出或 XML 文件迁移两条路;漏选关键项或路径错位,模板就彻底消失。
用 Export Settings 导出时必须手动勾选四项
PhpStorm 的 Export Settings… 对话框默认不包含代码片段配置,不勾选就等于没备份:
- 必须勾选
liveTemplates—— 否则所有自定义缩写(如logd、fore)全丢 - 必须勾选
fileTemplates—— 否则新建 PHP 类、Blade 模板时用的是空骨架,不是你带版权头的版本 - 必须勾选
colors—— 否则主题、编辑器高亮、字体颜色退回到灰白默认 - 必须勾选
inspectionProfiles—— 否则 PHPStan/PSALM 规则、未使用变量警告等检查项还原为默认 - 务必取消勾选
cache、system、plugins—— 这些是运行时生成数据,导入会冲突甚至导致启动卡死
直接复制 config/liveTemplates.xml 更快更稳
如果你只关心 Live Templates,且已有现成的 liveTemplates.xml(比如从同事那拿到的),直接替换文件比 GUI 导入更可靠:
- 关闭 PhpStorm,避免文件被锁
- 定位配置目录:
~/.config/JetBrains/PhpStorm2025.1/config/templates/(Linux/macOS)或%USERPROFILE%\.PhpStorm2025.1\config\templates\(Windows) - 把目标
liveTemplates.xml放进去,覆盖原文件 - 重启后进
Settings → Editor → Live Templates,检查是否出现在user组下 - 若未生效,右键该组 →
Change context→ 确保PHP已勾选
导入 JSON 片段集需确认格式兼容
部分团队用 JSON 格式管理片段(如 php-snippets.json),但 PhpStorm 只接受特定结构:
- 根节点必须是
template数组,每个项含abbreviation、description、value、context字段 -
context值必须为PHP(大小写敏感),否则导入后不触发 - 在
Settings → Editor → Live Templates页面点击右上角Import,选中 JSON 文件 - 导入后不会自动归组,所有模板默认进入
user组,需手动拖进自定义 Group
最易被忽略的是:XML 或 JSON 导入后,模板虽显示在列表里,但若没在 Define 中明确勾选 PHP 上下文,它在 .php 文件里根本不会响应 Tab 补全——这个动作必须手动补上,没有自动推断。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










