根本原因是模板未放在Files分类下或未正确关联扩展名；需检查Settings→Editor→File and Code Templates→Files中模板类型为Files、Extension字段正确、分组已展开且未禁用，PHP Interface等需重命名或新建并重启IDE。
新建文件时模板列表为空或不显示自定义模板
根本原因是模板没放在 Files 分类下，或者没正确关联文件扩展名。PhpStorm 的“新建文件”菜单（Alt+Insert）只读取 Editor > File and Code Templates > Files 里的模板，Includes 或 Live Templates 都不会出现。
检查和修复步骤：
- 打开
Settings > Editor > File and Code Templates > Files - 确认你的模板在左侧列表中，且类型是
Files（不是Includes） - 右键模板 →
Edit→ 检查Extension字段是否填了对应后缀，比如 PHP 类模板必须填php，接口模板也得是php（不是interface） - 如果模板属于某个分组（如
PHP Contracts），确保该分组已展开，且模板未被禁用（图标上没灰色斜杠）
为什么新建 .php 文件时只看到 “PHP Class”，看不到 “PHP Interface”
因为 PhpStorm 默认不把 PHP Interface 和 PHP Trait 当作独立模板类型注册进新建菜单——它只是在后台复制了 PHP Class 模板，名字改了但没绑定到文件创建流程。
必须手动让它出现在新建列表里：
立即学习“PHP免费学习笔记（深入）”；
- 在
Files列表中右键已有PHP Interface模板 →Rename，改成带空格的名称，比如PHP Interface（注意首字母大写、中间有空格） - 或者新建一个模板，
Name填PHP Interface，Extension填php，正文写interface $NAME$ - 重启 PhpStorm —— 这步不能跳，否则新建菜单缓存不刷新，仍只显示原始几个内置项
新建文件时想按用途快速筛选模板，比如 “Controller” 或 “Repository”
PhpStorm 不支持关键词搜索或分类折叠，但可以通过命名约定 + 分组实现视觉分层。
实操建议：
- 在
Files页面点击+→Template Group，建分组如PHP Layers - 在该分组下新建多个模板：
PHP Controller、PHP Repository、PHP Service，全部Extension设为php - 每个模板正文开头保留
#parse("PHP File Header.php")，确保$NAMESPACE$可用 - 模板内容差异化：Controller 模板写
class $NAME$ extends BaseController，Repository 模板写class $NAME$ implements RepositoryInterface
这样在 Alt+Insert 弹出的列表里，所有模板会按分组折叠显示，点开 PHP Layers 就能集中看到你定义的业务层模板。
点了 Alt+Insert 却弹出空白对话框或只有默认模板
常见于项目刚导入或目录结构未识别。核心判断依据是：当前焦点所在目录是否被标记为 Sources Root。
验证与修复：
- 在项目视图中右键你的
src/或app/目录 →Mark Directory as > Sources Root - 如果没有这个选项，说明该目录已被标记过；此时右键 →
Properties看路径是否带蓝色图标 - 如果目录是灰色的，或路径显示为
Excluded，则必须先取消排除，再重新标记 - 改完立刻重启 PhpStorm —— 缓存不清理会导致新建菜单始终读不到新模板或命名空间变量
最隐蔽的坑是：模板里用了 $NAMESPACE$，但目录没设为 Sources Root，结果新建时连模板名都不显示，你以为是模板坏了，其实是整个上下文没激活。
