PHP Class模板不生成命名空间因三个硬性条件未满足：#parse("PHP File Header.php")须在模板最开头；项目目录需标记为Sources Root；修改模板后必须重启PhpStorm。
PHP Class模板不生成命名空间？检查三个硬性条件
新建 PHP 类文件后没带 namespace，不是模板写错了，而是 $NAMESPACE$ 根本没被解析出来。这通常卡在三个地方：
-
#parse("PHP File Header.php")这行必须保留在模板正文最开头——删掉它，$NAMESPACE$就永远是空字符串 - 项目目录没标记为 Sources Root：右键目录 → Mark Directory as → Sources Root，否则 IDE 不知道从哪推导命名空间
- 改完模板后没重启 PhpStorm：缓存会继续输出原始变量名，比如直接显示
$NAMESPACE$而不是App\Controller
验证方式很简单：新建一个空白 .php 文件，手写 echo "$NAMESPACE$";，运行看输出。为空就说明上述任一环节失效。
Interface/Trait 模板生成的是 class？必须单独建模板
PhpStorm 默认没有真正的 PHP Interface 或 Trait 模板。你点“New → PHP Interface”，它其实是把 PHP Class 模板复制了一份，名字改了但内容没动。结果就是 UserServiceInterface 生成出来是 class UserServiceInterface，语法合法但语义错误。
- 进
Settings > Editor > File and Code Templates > Files - 点击
+→ Template Group（比如叫PHP Contracts） - 在该分组下新建模板：
Abbreviation填phpinterface，正文只写interface $NAME$，删掉所有extends、implements、public function等类专属结构 - 同理，Trait 模板写
trait $NAME$，且不要加implements或extends
$NAME$ 可用，但 $CLASS_NAME$ 是旧版弃用变量，别用。
立即学习“PHP免费学习笔记（深入）”；
$DATE$ 显示为文字而非真实日期？确认模板类型是 Files
生成文件里看到 // Created on $DATE$ 而不是 // Created on 2026/10/08，这不是系统时间设置问题，是模板引擎压根没启用变量替换。
- 只有 Files 分类下的模板才支持完整变量集（
$DATE$、$YEAR$、$USER$等） -
Includes 分类下的模板仅用于
#parse()引入，不参与新建文件时的变量展开 - 如果用了
#parse("xxx")，被引入的文件也必须放在 Files 下，否则变量无法传递 -
$DATE$格式固定为YYYY/MM/DD，不能改成Y-m-d；需要自定义格式得靠外部脚本或改用$TIME$配合正则替换
Live Template 触发不了？先查 Applicable in 和大小写
写了 sc 模板想快速生成 Controller，按 Tab 却没反应，大概率是作用域或拼写问题。
- 在 Live Template 设置里，点开模板 → Applicable in 必须勾选
PHP，且建议额外勾选Everywhere方便调试 - 缩写（
Abbreviation）区分大小写：SC和sc是两个不同模板 - 如果模板里用了
fileNameWithoutExtension()这类表达式，确保它只在支持的上下文中使用（比如新建文件时），否则会静默失败 - 光标必须落在 PHP 文件的类体外（如文件开头或空白行）才能触发，写在已有类内部可能被 IDE 忽略
最常被忽略的一点：Live Template 的变量表达式（比如 fileNameWithoutExtension()）和 File Template 的变量（比如 $NAMESPACE$）完全不互通，不能混用。前者只在代码编辑时生效，后者只在新建文件那一刻计算。
