PhpStorm 文件模板不支持动态占位符，仅支持预定义静态变量；$NAMESPACE$ 为空因缺少 #parse("PHP File Header.php") 或未标记 Sources Root，$NAME$ 是新建文件名而非类名，真动态需用 Live Templates。
PhpStorm 的文件模板（File Templates）本身不支持“动态占位符”——它只认预定义变量，且不能运行表达式或调用函数。所谓“动态”，其实是误传；真正能动态计算的只有 Live Templates，而 File Templates 仅做静态替换。
为什么 $NAMESPACE$ 有时为空、$NAME$ 不生效
这不是变量写错了，而是模板未被正确识别为 PHP 文件模板，或项目结构没配好：
-
$NAMESPACE$必须依赖#parse("PHP File Header.php")—— 这行必须出现在模板最开头，否则变量解析引擎不加载命名空间上下文 -
$NAME$是新建文件对话框里你输入的“文件名（不含 .php）”，不是当前类名；想取类名得用$CLASS_NAME$，但它只在 PHPDoc 模板中有效，不在 Files 分类的模板里可用 - 如果
$NAMESPACE$始终为空，检查项目根目录是否已标记为Sources Root（右键目录 → Mark Directory as → Sources Root） - 变量名大小写敏感：
$name$或${NAME}都不会被替换，必须严格写成$NAME$
哪些变量真能在 File Templates 里用
只有 Files 类型模板才支持完整变量集，且全部是预定义、不可扩展的：
-
$NAME$：新建时在对话框里填的名称（如UserRepository） -
$DATE$：固定格式YYYY/MM/DD，不能改；想用Y-m-d得靠外部脚本或放弃 -
$USER$：系统登录用户名，非 IDE 设置里的名字 -
$NAMESPACE$：仅当模板含#parse("PHP File Header.php")且目录为 Sources Root 时有效 -
$DS$：用来输出字面量$符号，写成$$会报错，必须用$DS$
想实现“真动态”？换用 Live Templates + 手动触发
File Templates 只在“新建文件”那一刻跑一次，没法响应编辑时的上下文。如果你需要：
立即学习“PHP免费学习笔记（深入）”；
- 自动插入当前类名、方法名、参数列表
- 根据光标位置生成带命名空间的 use 语句
- 选中一段代码后包裹
Log::debug()并保留原内容
那就别折腾 File Templates，直接上 Live Templates。例如建一个缩写 logd，模板体写 Log::debug('$SELECTION$');，再点 Edit variables 给 SELECTION 绑定 selection() 表达式——这才是 PhpStorm 唯一支持的“动态”路径。
很多人卡在以为 File Templates 能像 VS Code 的 snippets 那样写 JS 表达式，其实不能。它的变量机制更接近编译期宏，不是运行时求值。真要动态，就得接受：要么用 Live Templates 替代，要么接受 $NAMESPACE$ 和 $NAME$ 的有限能力。
