应配置PhpStorm的“PHP File”模板（非Includes），使用${USER}、${DATE}等变量，修改后必须重启IDE；变量不展开多因模板位置错误或未重启。
PHP 文件头注释怎么自动加作者和日期
新建 .php 文件时，文件头注释不显示真实作者名或日期，只看到 ${USER}、${DATE} 这类字面量——说明变量没展开，不是系统时间设置问题，而是模板类型选错了或没重启。
- 必须在
Settings > Editor > File and Code Templates > Files下修改PHP File模板，不能在Includes里改 - 变量一律用
${USER}、${DATE}、${YEAR}-${MONTH}-${DAY}格式，$USER$或$DATE$（带美元符号）是旧版写法，已失效 -
${DATE}固定为YYYY/MM/DD，无法改成Y-m-d；如需自定义格式，得用${YEAR}-${MONTH}-${DAY}拼接 - 改完必须重启 PhpStorm，否则缓存仍输出原始变量名
为什么新建 class 不带命名空间和 PHPDoc
$NAMESPACE$ 为空、类声明前没文档块，90% 是因为 PHP Class 模板里漏了 #parse("PHP File Header.php")，或者项目根目录没标为 Sources Root。
- 打开
File and Code Templates > Files > PHP Class，第一行必须保留#parse("PHP File Header.php")，否则$NAMESPACE$永远为空字符串 - 确保项目中实际存放类的目录右键 →
Mark Directory as > Sources Root，PSR-4 自动推导依赖这个标记 - 类前的 PHPDoc 要写成多行块：
/** * @package $NAMESPACE$ */，别用单行/** */，否则换行错乱、$NAME$不替换 -
$NAME$可用，但$CLASS_NAME$已弃用，别再用
interface/trait 模板为啥生成的是 class 关键字
默认模板不区分语法结构，PHP Interface 和 PHP Trait 模板根本不存在——你点新建 interface，IDE 实际套用的是 PHP Class 模板，所以生成 class XxxInterface。
- 进
File and Code Templates > Files，复制一份PHP Class，重命名为PHP Interface - 把模板正文里的
class $NAME$改成interface $NAME$，删掉extends \Exception、implements等类专属内容 - 同理建
PHP Trait模板，只留trait $NAME$，不加implements或extends - 所有模板变量（如
$NAME$、$NAMESPACE$）在 interface/trait 模板里照常生效
光标放哪才能一键生成类/函数 PHPDoc
输入 /** 后按 Enter 没反应？不是模板坏了，是光标位置错了。PhpStorm 对触发位置极其敏感。
立即学习“PHP免费学习笔记（深入）”；
- 类 PHPDoc：光标必须紧贴在
class关键字**正前方**（例如|class User {，竖线是光标），不能在类名后、不能在花括号里、不能在空行 - 函数 PHPDoc：光标必须在
function或public function的最左侧（|function getName()），箭头函数（const fn = () => {}）不支持 - 接口、trait 同样适用该规则，但前提是用了对应模板（见上一条）
- 如果想补全已有函数的参数注释，得用
Code > Generate > PHPDoc block，不是靠/** + Enter
文件头、类注释、函数注释三者变量作用域不同，模板位置不同，触发机制也不同——混用或只改一处，其他地方照样失效。最常被忽略的是 Sources Root 标记和重启 IDE 这两步。
