PhpStorm文件模板分三层：Files模板控制新建文件，Live Templates控制Tab展开，变量如$NAMESPACE$需#parse引入且目录须设为Sources Root，改后须重启IDE。
PhpStorm 文件模板不是“配一次就完事”的开关，而是分层生效的机制：新建 PHP Class 走的是 Files > PHP Class 模板，新建普通 .php 文件走的是 Files > PHP File 模板，而写代码时按 Tab 展开的缩写则依赖 Live Templates —— 三者不互通，改错地方就完全没效果。
为什么新建 PHP 类不带命名空间？
根本原因是 $NAMESPACE$ 变量为空，不是模板写得不对，而是变量注入链断了：
- 模板正文开头没保留
#parse("PHP File Header.php")—— 这行是命名空间解析的唯一入口，删掉或注释掉就彻底失效 - 项目目录没标记为
Sources Root（右键目录 →Mark Directory as → Sources Root），否则 PhpStorm 不知道该从哪段路径映射命名空间 - 改完模板后没重启 PhpStorm —— 缓存会继续输出字面量
$NAMESPACE$，而不是实际值
验证方法：新建一个空 PHP 文件，手写 echo "$NAMESPACE$";，运行看是否输出空字符串。如果是，上面三点至少有一项没到位。
Interface/Trait 总生成 class 关键字？必须单独建模板
PhpStorm 默认根本没有独立的 PHP Interface 或 PHP Trait 模板 —— 它只是把 PHP Class 模板复制了一份，名字改了但内容还是 class $NAME$。结果你新建 UserRepositoryInterface，生成的却是语法合法但语义错误的 class UserRepositoryInterface。
立即学习“PHP免费学习笔记（深入）”；
- 进
Settings > Editor > File and Code Templates > Files，点击+→Template Group（比如叫PHP Contracts） - 在该组下新建模板，
Abbreviation填phpinterface，正文只留：interface $NAME$ { }，删掉所有extends、implements、public function等类专属结构 - 同理，
phptrait模板写：trait $NAME$ { }，不加implements或extends -
$NAME$可用，但$CLASS_NAME$是旧版弃用变量，别用
$DATE$ 显示成文字而不是真实日期？确认模板类型是 Files
看到生成文件里写着 // Created on $DATE$，不是 // Created on 2026/10/09，这不是系统时间设置问题，是模板引擎压根没触发变量替换：
- 只有
Files分类下的模板才支持完整变量集（$DATE$、$YEAR$、$USER$等）；Includes分类下的模板仅用于#parse()引入，不参与新建文件时的变量展开 - 如果用了
#parse("PHP File Header.php")，被引入的文件也必须放在Files下，否则变量无法传递过去 -
$DATE$格式固定为YYYY/MM/DD，不能改成Y-m-d；如需自定义，得用$TIME$配合外部脚本，模板层做不到
Live Template 死活不触发？先查 Applicable in 和大小写
输入缩写（比如 phpecho）后按 Tab 没反应，大概率是上下文或拼写问题：
- 在
Live Templates设置页，选中模板后点Define，必须勾选PHP（不是PHP File或其他模糊选项） - 缩写区分大小写：
fore和Fore是两个不同模板，IDE 不会自动匹配 - 模板体里用了错误变量名（比如写成
$NAME少了花括号），PhpStorm 会静默忽略，导致整块模板不渲染 - 验证方式：在模板里临时加一行
// debug: $USER$，在 PHP 文件中触发缩写，看是否出现 —— 没出现就说明模板根本没被调用
变量注入和上下文绑定是隐性逻辑，不报错也不提示，出问题时只能靠手动验证每层是否生效。最常被跳过的其实是重启 IDE 和检查 Sources Root 标记 —— 这两步不做，其余全白搭。
