最稳方式是直接替换fileTemplates.xml文件，因其绕过GUI导入的勾选遗漏、插件缺失、重启遗漏等问题；根本原因是PHP Class模板未被调用，常见于新建普通.php文件、模板缺#parse、未标记Sources Root、变量名错误等。
最稳的方式是直接替换 fileTemplates.xml 文件，而不是走 GUI 导入 —— 因为导出时漏选、导入后不重启、插件没预装，都会导致模板静默失效。
为什么改了 PHP Class 模板却没生成命名空间
根本原因不是模板写错了，而是 PHP Class 模板压根没被调用。常见触发点：
- 你新建的是普通
.php文件（走的是PHP File模板），不是通过右键 → New → PHP Class 创建的 - 模板开头没保留
#parse("PHP File Header.php")，导致$NAMESPACE$始终为空字符串 - 项目根目录没标记为 Sources Root（右键目录 → Mark Directory as → Sources Root），
$NAMESPACE$就无法映射 PSR-4 结构 - 模板里用了
$NAME（少花括号）或已弃用的$CLASS_NAME，PhpStorm 静默跳过变量替换，输出字面量
手动替换 fileTemplates.xml 的实操路径
比 GUI 导入更稳：绕过勾选遗漏、插件缺失、重启遗漏等所有中间环节，直击配置文件本身。
- 先关掉 PhpStorm：
pkill -f phpstorm（只关窗口不行，后台进程常驻） - 定位当前版本配置目录：
ls -d ~/.config/JetBrains/PhpStorm*，确认如~/.config/JetBrains/PhpStorm2025.1 - 进该目录下的
config/options/，找到并替换fileTemplates.xml：
→ 若有备份：直接cp /backup/fileTemplates.xml ./fileTemplates.xml
→ 若无备份但记得改过哪几项：可临时从旧版本目录（如PhpStorm2024.3/config/options/）复制一份过来 - 重启 PhpStorm —— 不需要额外操作，模板立即生效
GUI 导入 .jar 时必须手动勾选的四项
如果坚持用 File → Manage IDE Settings → Export Settings 导出再导入，以下四项不勾等于白忙：
立即学习“PHP免费学习笔记（深入）”；
-
Editor → File and Code Templates（即fileTemplates） -
Editor → Color Scheme（对应colors，主题/高亮全靠它） -
Editor → Live Templates（liveTemplates，你的dd、log快捷片段） -
Editor → Inspections（inspectionProfiles，PHPStan/PSALM 规则、未使用变量警告开关）
同时务必取消勾选：cache、system、plugins—— 它们是运行时数据，导入会冲突甚至卡死启动。
真正容易被忽略的是：即使 fileTemplates.xml 已正确还原，若项目未标记 Sources Root，$NAMESPACE$ 就始终为空，新建类依然不带命名空间。
