file templates仅支持静态变量替换，不支持动态提示词或运行时交互；${xxx}在新建时求值固化，$xxx$为live templates专用语法。
文件模板（File Templates）不支持动态提示词，只支持静态变量替换
PHPStorm 的 File and Code Templates 本质是新建文件时的文本快照，不是运行时可交互的代码片段。它不支持类似 Live Templates 那样的 Tab 跳转、变量重计算或条件逻辑——所有 ${xxx} 变量在文件创建瞬间求值并固化，之后不会响应编辑行为。
常见误解是想让 ${NAME} 或 ${USER} 在保存后还能“自动更新”，这在 File Templates 中不可能实现。它只管“新建那一刻填什么”，不管后续改不改。
-
${DATE}每次新建都生成当天日期（格式固定为2026-10-09），但不会随文件保存时间变化 -
${USER}取自系统用户名，无法绑定 Git 配置；若要显示 Git 用户名，必须通过 JVM 参数-Dgit.user.name="Chenrui"启动 PhpStorm，并用$git_user_name$引用（注意：这里是$包裹，不是${}） -
${NAMESPACE}仅在项目已标记 Sources Root 且当前路径符合命名空间推导规则时才有效，否则为空字符串
想让注释里出现可跳转/可编辑的占位符？得用 Live Templates
如果你实际想要的是「输入 /** 回车后，光标停在 @param 后、能按 Tab 切换填参数名和类型」这类交互式体验，那根本不在 File Templates 职责范围内——这是 Live Templates 的能力。
例如，自定义函数文档模板：
/** * @param $PARAM_NAME$ $PARAM_TYPE$ * @return $RETURN_TYPE$ */
然后进 Settings → Editor → Live Templates → PHP，找到或新建 phpdoc 模板，在 Edit variables 里给 PARAM_NAME 设表达式 methodName()，勾选 Skip if defined，这样展开时就自动带入方法名，不用手动输。
- Live Template 中的变量必须用
$VAR$（美元+变量名+美元），不能写成${VAR} -
$END$是唯一特殊占位符，表示最终光标位置；其它变量如$METHOD_NAME$默认是空字符串，必须点Edit variables绑定 expression 才有值 - 别漏掉
Define → PHP Statement：否则在函数体内敲/**+ Enter 不会触发
File Templates 里混用 $xxx$ 和 ${xxx} 会导致变量失效
这是最常踩的坑：在 File and Code Templates → Includes → PHP Function Doc Comment 里，有人把 Live Template 风格的 $USER$ 直接粘过去，结果输出就是字面量 $USER$，而不是用户名。
原因很简单：File Templates 只识别 ${xxx} 格式，$xxx$ 被当普通文本原样保留。
- 正确写法：
* @author ${USER}（输出系统用户名） - 错误写法：
* @author $USER$（输出字符串$USER$） - 想显示 Git 用户名？先加 JVM 参数，再写
* @author $git_user_name$（注意这里必须用$包裹，且依赖启动参数）
批量更新旧文件年份？别指望 File Templates，得配 Copyright Profile
很多人想靠文件模板解决“所有老文件的 ${YEAR} 自动变成 2026”，但 ${YEAR} 在 File Templates 中不可靠，且它只作用于新建文件，对已有文件完全无感。
真正能批量更新版权声明年份的，是 PhpStorm 内置的 Copyright 功能：
- 进
Settings → Editor → Copyright → Copyright Profiles，新建 profile 并设好作者和许可证文本 - 在
Copyright to Files里选中目标文件范围，勾选Update copyright notice in existing files - 关键设置：勾选
Notice template中的Replace current year with latest year，这样扫描时会把2025自动升为2026
这个机制和 File Templates 完全无关，也无需写任何变量语法——它是独立的文本匹配+替换引擎。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
