PhpStorm 新建 PHP 类自动带命名空间和文档块，需正确配置 File Templates 中的 PHP Class 模板：保留 #parse("PHP File Header.php") 以解析 $NAMESPACE$，在类前添加标准 PHPDoc，确保目录标记为 Sources Root，并重启 IDE 生效。
怎么让新 PHP 类自动带命名空间和文档块
PhpStorm 的文件模板不是“写完再补”，而是从新建那一刻就决定代码质量。关键在 File Templates 里改 PHP Class 模板，而不是靠插件或手动格式化。
常见错误是直接粘贴一段注释进去，结果 $NAME$ 不替换、$NAMESPACE$ 取不到值、生成后还要删空行——本质是没启用 PhpStorm 的内置变量解析。
- 打开
Settings > Editor > File and Code Templates > Files > PHP Class - 模板正文开头必须保留
#parse("PHP File Header.php")（否则$NAMESPACE$为空） - 类声明前加标准 PHPDoc：
/** * @package $NAMESPACE$ */
，别用/** */单行写法，否则换行错乱 - 如果项目用 PSR-4，确保
Directories里已标记Sources Root，否则$NAMESPACE$始终为空字符串
为什么新建 interface 或 trait 总不带 abstract 或 interface 关键字
因为默认模板把 PHP Interface 和 PHP Trait 当作普通类处理，没做语法区分。这不是 Bug，是模板没覆盖语言特性。
实际场景中，你新建 UserServiceInterface，结果生成的是 class UserServiceInterface，IDE 不报错但语义全错。
立即学习“PHP免费学习笔记（深入）”；
- 进
File Templates > Files，复制一份PHP Class，重命名为PHP Interface - 把
class $NAME$改成interface $NAME$，删掉extends \Exception这类类专属内容 - 同理，
PHP Trait模板里写trait $NAME$，且不要加implements或extends - 注意：
$NAME$变量在 interface 模板里仍可用，但$CLASS_NAME$是旧版遗留变量，已弃用，别用
模板里 $DATE$ 和 $YEAR$ 总是不对，甚至显示为文字
这是模板引擎未启用变量替换的典型表现，不是系统时间设置问题。PhpStorm 默认关闭部分变量的实时解析，尤其在自定义模板里。
比如你看到生成的文件里写着 // Created on $DATE$，而不是真实日期，说明变量没被展开。
- 确认模板类型选的是
Files（不是Includes），只有Files类型支持完整变量集 -
$DATE$格式固定为YYYY/MM/DD，不能改成Y-m-d；如需自定义，得用$TIME$+ 外部脚本，模板层做不到 - 如果用了
#parse("xxx")引入其他模板，被引入的文件也必须在Files分类下，否则变量不传递 - 重启 PhpStorm 才能生效——改完模板不重启，旧缓存会继续输出原始变量名
如何让模板适配不同框架（Laravel / Symfony / 自研）
硬编码框架路径或命名空间会卡死协作，正确做法是用条件变量 + 项目级配置联动，而不是为每个框架建一套模板。
例如 Laravel 的 app/Models/User.php 要生成 App\Models\User，而 Symfony 的 src/Entity/User.php 要生成 App\Entity\User，靠模板本身无法自动识别，得借力目录结构。
- 在
Settings > Directories里，把 Laravel 的app标为Sources Root，Symfony 的src同样标为Sources Root - 模板中统一用
$NAMESPACE$，PhpStorm 会根据当前文件所在 Sources Root 自动推导 - 如果框架强制要求特定父类（如 Laravel Model 必须 extends
Illuminate\Database\Eloquent\Model），在模板里写成class $NAME$ extends \Illuminate\Database\Eloquent\Model，但加个注释说明：// ⚠️ 仅 Laravel 项目启用，其他项目请手动删除 - 避免用
$PROJECT_NAME$做判断——它返回的是项目文件夹名，不是 Composer name，不可靠
最麻烦的其实是 vendor 包里的模板复用：你改了全局模板，但团队成员没同步，或者 CI 环境没配。所以关键不是功能多强，而是模板文件本身要进 Git，放在 .idea/fileTemplates/ 下，且确保 .idea 不在 .gitignore 里——这点最容易被忽略。
