$NAMESPACE$为空是因为#parse("PHP File Header.php")缺失、目录未设为Sources Root或未重启PhpStorm；三者缺一不可。
PHP Class 模板里 $NAMESPACE$ 为空？先确认三件事
新建 Model 类时命名空间没生成，不是模板写错了，而是变量根本没被注入。关键就三点：#parse("PHP File Header.php") 必须在模板第一行、src/（或你的模型目录）必须标记为 Sources Root、改完模板后必须重启 PhpStorm。
常见错误是删掉那行 #parse，以为自己写 namespace $NAMESPACE$ 就够了——结果 $NAMESPACE$ 始终为空字符串。验证方法：新建一个空 .php 文件，手写 <?php echo "$NAMESPACE$"; ?>，运行看输出是不是空。
- 模板开头漏了
#parse("PHP File Header.php")→ 变量解析链断裂 - 模型文件放在
app/Models但没右键 → Mark Directory as → Sources Root → IDE 不知道从哪推导命名空间 - 改完模板直接新建文件 → 缓存未刷新，仍显示
$NAMESPACE$字面量
Model 类需要专属模板？别复用 PHP Class
如果你的项目约定 Model 类必须继承 Illuminate\Database\Eloquent\Model、带 protected $table、启用 timestamps 等，就别硬套默认 PHP Class 模板。它不区分业务语义，生成的只是裸类骨架。
正确做法是在 Settings > Editor > File and Code Templates > Files 里新建一个模板，比如叫 PHP Model，内容示例：
立即学习“PHP免费学习笔记（深入）”；
/**
* @package $NAMESPACE$
*/
namespace $NAMESPACE$;
<p>use Illuminate\Database\Eloquent\Model;</p><p>class $NAME$ extends Model
{
protected $table = '$NAME$';
public $timestamps = true;
}注意：$NAME$ 是唯一推荐变量，$CLASS_NAME$ 已弃用；$NAMESPACE$ 能正常取值的前提仍是上面三点已满足。
Live Template 才适合高频代码片段，比如 fillable 或 casts
文件模板（File Templates）管的是“新建整个文件”，而字段定义、属性声明这类重复代码，该交给 Live Template。比如输入 fill + Tab 自动展开 protected $fillable = [''];，光标停在引号内。
配置要点：
- 路径：
Settings > Editor > Live Templates > + > Live Template -
Abbreviation填fill，Template text填protected $fillable = ['$END$']; - 点
Define→ 勾选 PHP Statement（不是 Everywhere） - 底部务必勾选 Reformat according to style，否则缩进错乱
同理可建 casts 模板：protected $casts = ['id' => 'integer'];，把 id 设为第一个跳转位，按 Tab 就能快速改字段名。
日期、作者等元信息怎么加才不翻车
$DATE$ 在文件模板里固定输出 YYYY/MM/DD，没法改成 Y-m-d；想拼出 2026-10-09，得用 $YEAR$-$MONTH$-$DAY$ 组合。
但要注意：$DATE$ 只在 Files 分类下的模板 有效；如果误建在 Includes 下，它就真变成文字 $DATE$。另外，作者信息别硬写 @author $USER$ —— $USER$ 是系统登录名，不是你 Git 配置里的姓名，容易暴露账号或写错。
更稳妥的做法是：在模板里留空行，手填作者，或用 Live Template 单独管理作者块。
