php 类模板必须保留 #parse("php file header.php") 且置于最开头，否则 $namespace$ 无法解析导致命名空间为空；该语句激活 phpstorm 对目录结构的识别，从而正确生成命名空间、phpdoc 和 strict_types 声明。
新建 PHP 类文件时没自动带命名空间、没标准 PHPDoc、还得手动删空行或补 declare(strict_types=1)？根本不是 PhpStorm 不够智能，而是你用的不是正确的模板路径，也没触发变量解析机制。
PHP Class 模板里必须保留 #parse("PHP File Header.php")
这是决定 $NAMESPACE$ 能否取到值的关键。很多用户删掉这行，改用硬编码注释，结果生成的类永远是 namespace ; 或直接空着——因为 $NAMESPACE$ 依赖 PhpStorm 内部对目录结构的识别，而该识别只在 #parse 引入的模板中被激活。
-
#parse("PHP File Header.php")必须放在模板最开头（甚至在<?php前），且文件名要完全一致，包括大小写和.php后缀 - 对应的
PHP File Header.php模板必须建在 Includes 标签页下，不能建在 Files 里 - 如果项目用 PSR-4，确保实际的源码目录已右键 → Mark Directory as → Sources Root，否则
$NAMESPACE$永远为空字符串 - 改完立刻重启 PhpStorm，否则缓存会继续输出
$NAMESPACE$字面量（不是报错，是静默失败）
类声明前加 PHPDoc 要用多行格式，别用单行 /** */
写成 /** * @package $NAMESPACE$ */ 看似省事，但会导致换行错乱：生成后注释和 class 关键字挤在同一行，或者空行位置不可控。PhpStorm 的模板引擎对单行 PHPDoc 的解析逻辑不同。
- 必须写成三行以上结构：
/** * @package $NAMESPACE$ */
-
@package后直接跟$NAMESPACE$，不加空格也不加引号；变量名大小写敏感，$namespace$或$nameSpace$都无效 - 如果需要
@author $USER$，同样加在多行 PHPDoc 内，$USER$是系统级变量，无需额外配置 - 不建议在类级 PHPDoc 里写
@inheritdoc，它只适用于继承/实现场景，放错位置反而干扰文档工具解析
Interface 和 Trait 模板不能复用 Class 模板
直接复制 PHP Class 模板去新建 UserRepositoryInterface，结果生成的是 class UserRepositoryInterface —— IDE 不报语法错误，但语义全错，后续类型提示、静态分析都会出问题。
- 进 File and Code Templates → Files，点击
+新建模板，Name 填PHP Interface，Extension 填php - 模板正文写：
interface $NAME$ { }，删掉所有extends、implements、__construct相关内容 - 同理新建
PHP Trait模板，正文只留：trait $NAME$ { } -
$NAME$变量在 interface/trait 模板中照常生效；$CLASS_NAME$是旧版遗留变量，已弃用，别用
变量不展开？先验证是不是模板根本没被调用
看到生成的文件里写着 // Created on $DATE$ 而不是真实日期，第一反应不该是“变量坏了”，而是“这个文件压根没走你改的那个模板”。
- 确认你新建的是 New → PHP Class（不是 New → File → 输入
xxx.php），后者走的是PHP File模板，和PHP Class模板完全无关 - 临时在模板里加一行
// debug: ${NAME} | ${NAMESPACE}，新建类看是否输出；没输出说明模板路径或触发方式错了 - 变量必须用
${NAME}大括号格式，$NAME$在部分旧模板里兼容，但新版推荐统一用${} -
$DATE$固定为YYYY/MM/DD格式，无法在模板层改成Y-m-d；如需自定义，得靠外部脚本或 Live Template 补位
最易被忽略的一点：模板改完不重启，等于没改。PhpStorm 对文件模板的加载是启动时一次性读取并缓存的，运行中修改只是写入磁盘，不会热重载。哪怕只动了一个空格，也得关掉再开。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
