最可靠的方式是手动替换fileTemplates.xml，因其绕过GUI导入的勾选遗漏、插件缺失、重启遗漏等问题，直接恢复配置文件本身，且需确保项目根目录标记为Sources Root才能使$NAMESPACE$正确解析。
直接恢复文件模板设置最可靠的方式是手动替换 fileTemplates.xml，而不是依赖 GUI 导入 —— 因为导出时漏选 fileTemplates 会导致模板静默丢失，且导入后不重启、不预装插件，模板根本不会生效。
为什么改了 PHP Class 模板却没生成命名空间和 DocBlock
根本原因不是模板写错了，而是 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$ 仍为空；而这个标记动作在 GUI 导入流程里完全不涉及，必须手动补上。
