PHP Service 类需单独新建模板，不能复用 PHP Class；必须保留 #parse("PHP File Header.php")、标记目录为 Sources Root、重启 IDE，否则 $NAMESPACE$ 为空；PHPDoc 需标准多行格式且置于 namespace 后、class 前。
PHP Service 类模板必须单独新建，不能复用 PHP Class
新建 UserService 却生成 class UserService，不是 IDE 抽风，是 PhpStorm 根本没提供原生的 Service 模板——它只内置了 PHP Class、PHP Interface、PHP Trait 三类，Service 属于业务约定，得手动建。
直接改 PHP Class 模板会污染所有类文件；复制一份后不改内容，新建时仍带 extends \Exception 或 implements，导致语法冗余甚至错误。
- 进
Settings → Editor → File and Code Templates → Files - 点
+→Template Group，起名如PHP Services - 在该分组下点
+→File Template，名称填PHP Service，扩展名填.php - 模板正文按需写，例如：
/** * @package $NAMESPACE$ */ class $NAME$
注意：开头别删 #parse("PHP File Header.php")，否则 $NAMESPACE$ 为空；$NAME$ 保留，别用已弃用的 $CLASS_NAME$。
命名空间为空？检查三个硬性条件
$NAMESPACE$ 显示为文字或留空，90% 是以下任一环节断了：
立即学习“PHP免费学习笔记（深入）”；
- 模板第一行缺失
#parse("PHP File Header.php")—— 这不是可选，是命名空间解析的唯一入口 - 你的服务类所在目录（如
src/Services/）没被标记为Sources Root（右键目录 →Mark Directory as → Sources Root） - 改完模板后没重启 PhpStorm —— 缓存不刷新，变量永远不展开
验证方式：新建一个空 .php 文件，手写 echo "$NAMESPACE$";，运行看输出。为空就说明上述某条没满足。
模板里怎么自动补 __construct 和依赖注入？
Service 类常要构造函数注入 Repository 或 Client，但文件模板不支持逻辑判断，只能靠静态结构 + 后续 Live Template 补足。
推荐做法是：文件模板只管骨架，构造函数用 Live Template 快速插入。
- 在
PHP Service模板正文末尾加一行空行 + 占位注释，例如：
class $NAME$
{
// [constructor]
}然后另建一个 Live Template：Abbreviation 填 ctor，Template text 写：
public function __construct($END$)
{
$END$
}点 Define → 勾选 PHP 和 PHP Statement，再进 Edit variables 给第一个 $END$ 勾 Skip if defined —— 这样按 Tab 光标直接跳到参数位置，不卡在空行。
这样既保持文件模板轻量，又把高频操作交给可复用、可跳转的 Live Template。
为什么 PHPDoc 换行错乱或贴在 class 同一行？
不是缩进问题，是 PHPDoc 块的写法触发了 PhpStorm 的解析歧义。
- 必须用标准块格式：以
/**开头、换行、*开头写内容、换行、*/结尾；写成单行/** @package $NAMESPACE$ */会导致注释被压到 class 同一行 - PHPDoc 必须放在
namespace声明之后、class声明之前；顺序错，IDE 可能当普通注释处理 - 如果用了
#parse("xxx")引入其他模板，被引入的文件也必须在Files分类下，否则$NAMESPACE$等变量无法传递
最容易被忽略的是：模板编辑框里手敲的空格/Tab/换行符，和 PhpStorm 自动重排缩进冲突。解决办法是——模板里只写逻辑结构，关掉“手动调格式”，勾选底部 Reformat according to style，让 IDE 自己算缩进。
