PhpStorm 文件模板是确保新文件代码合规的关键，必须在 PHP Class 模板首行保留 #parse("PHP File Header.php") 以动态获取 $NAMESPACE$，且需标记 Sources Root、使用 ${DATE} 等正确变量语法，否则命名空间为空或模板不生效。
PhpStorm 的文件模板（File Templates）不是“锦上添花”的功能，而是决定新文件第一行代码是否合规的关键开关。不配模板，新建的 UserServiceInterface 会默认生成 class UserServiceInterface；不启用变量解析，$NAMESPACE$ 就永远是字面量字符串。
PHP Class 模板必须保留 #parse("PHP File Header.php")
这是获取 $NAMESPACE$ 的唯一可靠方式。很多团队手动在模板里写 namespace App\Services;，结果换目录就失效——因为 $NAMESPACE$ 是动态计算的，依赖项目中已标记的 Sources Root。
- 打开 Settings > Editor > File and Code Templates > Files > PHP Class
- 模板开头第一行必须是
#parse("PHP File Header.php")，不能删、不能注释、不能挪到第二行 - 如果项目用 PSR-4，确保对应目录已在 Project View 中右键 → Mark Directory as > Sources Root
- 改完必须重启 PhpStorm，否则
$NAMESPACE$仍为空字符串
Interface 和 Trait 模板要单独建，不能复用 Class 模板
PhpStorm 默认没有为 interface 或 trait 提供语法感知的模板，直接新建会套用 class $NAME$，导致语义错误且 IDE 不报错。
- 在 File and Code Templates > Files 里，复制一份
PHP Class，重命名为PHP Interface - 把
class $NAME$改成interface $NAME$，删掉extends \Exception、implements等类专属内容 - 同理建
PHP Trait，只留trait $NAME$，不要加implements或extends -
$NAME$可用，但$CLASS_NAME$是弃用变量，别用
日期和版权变量要用 ${DATE}，不能用 $DATE$ 或 ${YEAR}
$DATE$ 是旧版 Freemarker 风格变量，在 PhpStorm 文件模板中已不被支持；${YEAR} 解析不稳定，跨年时经常卡在 2025；只有 ${DATE} 能每天自动更新为 2026-10-09 格式。
立即学习“PHP免费学习笔记（深入）”；
- PHP File 模板中写
/* Created on ${DATE} */，不是$DATE$也不是${YEAR}-${MONTH}-${DAY} - 所有变量必须严格用
${xxx}包裹，多一个空格或少一个$，就原样输出文字 - 如果要注入 Git 用户名，需通过 VM 参数
-Dgit.user.name="Your Name"启动 PhpStorm，模板中用$git_user_name$
模板改完不生效？先看这三处
变量不展开、命名空间为空、快捷键格式化没反应……这些问题 90% 出在配置链路断点上，而不是模板内容本身。
- 确认模板类型是 Files（不是 Includes），只有 Files 类型支持完整变量集
- 检查右下角状态栏：如果是
Plain Text或HTML，说明文件类型识别错误，右键 → Override File Type 改为 PHP - 新建文件后光标没落在类声明前？PhpStorm 只在类/接口/函数定义块内才触发文档块补全，别在空白行按回车
真正难的不是写对一行 #parse，而是让整个模板链——从 Sources Root 标记、变量语法、到 IDE 缓存刷新——全部咬合运转。少一个环节，$NAMESPACE$ 就永远是空的。
