PhpStorm新建PHP类不带命名空间和PHPDoc，根本原因是PHP Class模板未保留首行#parse("PHP File Header.php")，导致$NAMESPACE$无法解析；必须将其置于模板最开头、确保PHP File Header.php存在于Files分类下、PHPDoc置于其后、区分Interface/Trait独立模板，并重启IDE生效。
PhpStorm 新建 PHP 类时默认不带命名空间和标准 PHPDoc，是因为 PHP Class 模板没正确配置变量解析逻辑，不是插件或格式化能解决的。
PHP Class 模板必须保留 #parse("PHP File Header.php")
这是最关键的一步。如果删掉或注释掉这行，$NAMESPACE$ 就永远为空字符串——哪怕你项目已标记为 Sources Root 也没用。这个指令会触发 PhpStorm 加载内置的文件头模板，并把当前目录结构映射为命名空间。它不是可选装饰，是变量传递的唯一通道。
-
#parse("PHP File Header.php")必须写在模板最开头（空行也算），不能缩进、不能加空格 - 如果你看到生成的类里
namespace ;或直接空白，基本就是这行缺失或路径写错 - 该被引用的
PHP File Header.php模板本身必须存在于Files分类下（不是 Includes），否则变量不向下传递
类声明前要加完整 PHPDoc 块，别用单行写法
光有 #parse 不够，还得让 PHPDoc 能正确展开 $NAMESPACE$。常见错误是写成 /** @package $NAMESPACE$ */ 这种单行格式，结果换行错乱、@package 后面直接跟空格甚至换行符。
- 必须用多行块：
/** * @package $NAMESPACE$ */
- 不要在
/**和*/之间留空行，否则生成后会有冗余空行 -
$NAMESPACE$只在#parse执行后才有效，所以 PHPDoc 必须放在#parse下方，不能颠倒顺序
Interface 和 Trait 模板得单独配，不能复用 Class 模板
新建 UserRepositoryInterface 却生成 class UserRepositoryInterface，说明你还在用 PHP Class 模板创建 interface——语法层面就错了，IDE 不报错但语义全毁。
立即学习“PHP免费学习笔记（深入）”；
- 进
Settings > Editor > File and Code Templates > Files，复制一份PHP Class，重命名为PHP Interface - 把
class $NAME$改成interface $NAME$，删掉extends \Exception、implements等类专属内容 - 同理，
PHP Trait模板里只写trait $NAME$，不加extends或implements -
$NAME$在所有模板里都可用；$CLASS_NAME$是旧版弃用变量，别用
改完必须彻底重启 PhpStorm，否则变量还是原样
你看到生成文件里写着 // Created on $DATE$ 而不是真实日期，或者 namespace $NAMESPACE$ 没展开，大概率是缓存没刷新。这不是配置错，是进程没重载。
- macOS：Dock 图标右键 → Quit（不是 Close Window）
- Windows：任务栏右键 → Close window，再确认后台 phpstorm.exe 进程已结束
- Linux：运行
ps aux | grep phpstorm，手动kill剩余进程 -
Invalidate Caches and Restart不等于重载模板变量，它不触碰 JVM 层参数和模板缓存
最常被忽略的是：一旦你保存过一个永久运行配置，后续新建就不再读模板，而是基于上次配置复制。所以模板改完，记得删掉旧的临时配置再试；另外，$DATE$ 格式固定为 YYYY/MM/DD，想改成 Y-m-d 得靠外部脚本，模板层做不到。
