新建文件不套用模板是因为入口选错：New→PHP File仅用PHP File模板（${NAMESPACE}恒为空），New→PHP Class才用PHP Class模板（需目录设为Sources Root且含#parse指令），New→File手动输扩展名则走纯文本模板。
新建文件不套用模板，基本是因为你点错了入口——右键 New → PHP File 走的是 PHP File 模板，而 New → PHP Class 才走 PHP Class 模板。两者变量、结构、生效条件全不同，混用就白配。
确认你用的是哪个“新建”路径
PhpStorm 里“新建文件”有至少三种行为，对应三类模板：
-
New → PHP File：只读PHP File模板（位于Files标签下），支持${DATE}、${USER}，但${NAMESPACE}永远为空 -
New → PHP Class：读PHP Class模板，能解析${NAMESPACE}，但前提是目录已标记为Sources Root -
New → File后手动输xxx.php：走默认文本模板，不触发任何 PHP 变量解析
常见错误是改了 PHP Class 模板，却用 New → PHP File 创建，结果发现 ${NAMESPACE} 没渲染、${NAME} 是空的——不是模板坏了，是根本没调用它。
为什么 ${NAMESPACE} 总是空字符串
${NAMESPACE} 不是靠猜出来的，它依赖两个硬性条件同时满足：
立即学习“PHP免费学习笔记（深入）”；
- 模板第一行必须保留
#parse("PHP File Header.php")—— 这是 PhpStorm 唯一识别命名空间推导的钩子，删掉或注释掉就失效 - 对应目录（如
src/）必须右键 →Mark Directory as → Sources Root，且点击Apply（只点OK不生效） - 改完必须重启 PhpStorm —— 缓存不刷新，
${NAMESPACE}就一直显示为字面量
验证方法：新建一个空 .php 文件，写 <?php echo "${NAMESPACE}"; ?>，运行看输出。为空？上面三点至少漏了一项。
Interface 和 Trait 必须单独建模板
默认没有独立的 PHP Interface 或 PHP Trait 模板。你点 New → PHP Interface，IDE 实际复用的是 PHP Class 模板，所以生成的是 class XxxInterface —— 语法合法但语义错误。
- 进
Settings → Editor → File and Code Templates → Files，点击+→Template Group新建分组（如PHP Contracts） - 在该分组下新建模板，名称填
PHP Interface，扩展名留空，内容写：interface ${NAME} { } - 同理建
PHP Trait模板，内容为：trait ${NAME} { } - 删掉所有
extends、implements、public function等类专属结构
别用 ${CLASS_NAME} —— 这是弃用变量，${NAME} 才是当前文件名（不含 .php）的正确写法。
日期和作者信息填不准？检查变量写法和模板类型
${DATE} 和 $USER$ 看似简单，但错一个字符就原样输出：
- 必须用
${DATE}，不是$DATE$、${date}或${YEAR}—— 后者跨年不更新，且解析不稳定 -
${DATE}格式固定为2026/10/08，无法改成2026-10-08；如需该格式，只能拼${YEAR}-${MONTH}-${DAY} -
$USER$取操作系统用户名，不是 Git 用户名；要填git config --get user.name，得加 JVM 参数-Dgit.user.name=xxx，模板里用$git_user_name$ - 所有变量必须严格包裹在
${}内，多一个空格、少一个$，就当普通文本输出
最常被忽略的是：只有 Files 分类下的模板才支持完整变量集。Includes 分类里的文件（比如 PHP File Header.php）仅用于 #parse() 引入，不能直接新建，也不展开变量。
