PHP函数注释模板应在File and Code Templates→Includes→PHP Function Doc Comment中修改，而非Live Templates；变量如${DATE}直接可用，${USER}不存在，需用$USER$并配合Live Templates配置默认值。
PHP 函数注释模板在哪改
改的是 File and Code Templates → Includes → PHP Function Doc Comment，不是 Live Templates。很多人误点到 Live Templates 里去配，结果输入 /** 回车后变量（比如 ${DATE}）原样输出，不解析——因为 Live Templates 只负责触发快捷键，而函数注释的变量展开逻辑只在 File Templates 的 Includes 里生效。
默认模板长这样：/** ${PARAM_DOC} #if(${TYPE_HINT} != "void")* @return ${TYPE_HINT} #end ${THROWS_DOC} */
它只生成参数和返回值，没作者、没时间、没备注栏。要加就得手动往里塞：* @author $USER$、* @created ${DATE} ${TIME}，注意变量大小写敏感，$USER$ 是 Live Template 变量（需提前在 Live Templates 里设好默认值），${DATE} 是 File Template 变量（直接可用）。
常见错误：
- 把
${USER}写成$user$或USER—— 不展开，原样输出 - 在模板里混用
$USER$和${USER}—— 前者依赖 Live Template 配置，后者根本不存在 - 改完没点 Apply，只点 OK —— 设置不生效
类注释为什么按 /** 回车没反应
光标必须紧贴 class 关键字左侧，不能在类名后、不能在花括号里、不能在空行上。例如这一行：class User {，光标得停在 c 前面，也就是整行最开头。错位了就只会生成普通多行注释 /* ... */，不会调 PHP Class Doc Comment 模板。
类模板路径是：File and Code Templates → Includes → PHP Class Doc Comment。默认不含 @package 或 @author，得手动加：* @package ${NAMESPACE}。但注意：${NAMESPACE} 要生效，对应目录必须标记为 Sources Root（右键目录 → Mark Directory as → Sources Root）。
立即学习“PHP免费学习笔记（深入）”；
另外：@inheritdoc 不会自动插入，哪怕子类重写了父类方法。如果团队要求显式声明继承关系，得在模板末尾手加一行：* @inheritdoc。
新建 PHP 文件时怎么自动带版权头
改的是 File and Code Templates → Files → PHP File，不是 Includes 里的任何一项。这里填的才是新建 .php 文件时第一屏看到的内容。
推荐结构（可直接复制）：/**\n * @package ${NAMESPACE}\n * @author $USER$\n * @created ${DATE} ${TIME}\n * @copyright Copyright ${DATE.substring(0, 4)} ${USER}\n */
关键点：
- 年份必须用
${DATE.substring(0, 4)}，别用${YEAR}—— 后者跨年容易卡死在旧值 -
${NAMESPACE}为空？检查是否标记了 Sources Root，且当前文件在该目录下 - 想显示 Git 用户名而非系统用户名？得改 IDE 启动参数：
-Dgit.user.name=$(git config --get user.name)，然后模板里用$git_user_name$（点号变下划线） - 变量必须严格用
${xxx}或$xxx$包裹，多一个空格就失效
自定义 @author 和动态日期为什么总不更新
$DATE$ 和 $TIME$ 在 Live Templates 里只计算一次：生成注释那一刻的值，之后不会变。你不可能让已存在的注释里的日期“自动跳到明天”。同理，$USER$ 默认取操作系统登录名，改 Git 配置不生效，除非通过 VM 参数注入并重启 IDE。
Live Template 中编辑变量的正确姿势：
- 进
Settings → Editor → Live Templates → PHP → phpdoc - 点 Edit variables
- 给
USER设默认值（如"Zhang San"），给DATE设表达式date("Y-m-d") - 模板正文里写
* @author $USER$和* @date $DATE$
注意：date("Y-m-d") 是 PHP 风格写法，不是 JavaScript；$DATE$（Live Template）和 ${DATE}（File Template）是两套机制，不能混用。
最容易被忽略的一点：所有这些模板变量，只有在 PhpStorm 能准确识别上下文时才可靠。比如函数没写返回类型声明、参数全靠 ...$args，${TYPE_HINT} 就会 fallback 成 mixed 或 void，这时候手动补类型比等推断更省事。
