PHPStorm严格依赖文件类型与扩展名的显式映射来识别文件，不基于内容或shebang自动推断；需在Settings→Editor→File Types中手动将扩展名（如*.blade.php）添加到对应类型（如PHP）的Registered Patterns中，且须注意匹配优先级、多级扩展名限制及项目/IDE设置层级。
PHPStorm 识别自定义扩展名靠的是文件类型映射，不是“猜”
PHPStorm 不会像某些编辑器那样根据文件内容或 shebang 行自动推断语言 —— 它严格依赖 file type 与扩展名的显式映射。如果你打开 config.blade.php 或 routes.api 没有语法高亮、跳转失效，大概率是 PHPStorm 根本没把它当成 PHP 或 YAML 文件处理，而不是插件没装或缓存没清。
手动关联扩展名到已有文件类型（最常用）
这是解决 90% 自定义扩展名问题的首选方式，无需写脚本、不改配置文件路径，直接在 UI 里完成：
- 打开
File → Settings → Editor → File Types（macOS 是PhpStorm → Preferences → Editor → File Types） - 在左侧列表中找到目标语言类型，比如
PHP、YAML、JavaScript等（注意不是“Auto-detect”，那是另一个机制） - 在右侧
Registered Patterns区域点击+，输入你的扩展名，例如：*.blade.php、*.api、*.conf.js - 确认没有其他文件类型已抢先注册了相同模式（比如
*.js被JavaScript占了，但*.conf.js没被占，就可以安全加）
⚠️ 注意：*.blade 和 *.blade.php 是两个不同模式；如果文件是 foo.blade.php，必须填 *.blade.php，填 *.blade 无效。
创建新文件类型并绑定扩展名（适合特殊格式）
当你的文件既不是标准 PHP，也不是 JSON/YAML，而是带业务语义的 DSL（比如 .bdoc、.asice），又需要独立高亮或补全时，就得新建一个文件类型：
立即学习“PHP免费学习笔记（深入）”；
- 在
File Types设置页点击左下角+（Add new file type） - 选
Custom→ 填名称如BDOC，再点OK - 回到列表选中刚建的
BDOC，在Registered Patterns加*.bdoc - 往下拉，设置
Syntax highlighting：可复用现有方案（如选XML或Text），或后续通过插件/自定义 lexer 扩展
这个方式不会影响其他功能（比如代码检查仍走 PHP 解析器），只管高亮和基础编辑行为。不需要重启，改完立刻生效。
为什么改了扩展名还是不生效？几个硬坑
常见现象：明明在 File Types 里加了 *.env.local 到 Properties 类型，但打开文件仍是灰色字体、无高亮 —— 很可能踩了下面这些坑：
-
Properties类型默认禁用了Recognized file names中的.env模式，而它优先级高于通配符。得先取消勾选该内置模式，否则*.env.local永远不匹配 - 扩展名含点号（如
.api.v1）不能写成*.api.v1—— PHPStorm 把它当字面量匹配，实际要写*.api.*或拆成多个条目：*.api.v1、*.api.v2 - 项目级设置（
.idea/fileTemplates或.idea/misc.xml）可能覆盖全局映射。检查Settings → Editor → File Types右上角是否显示 “Project” 而非 “IDE”，切换回 IDE 级别再试 - PHPStorm 2025.3+ 对多级扩展名（如
foo.test.tsx）支持变严格：只有最后一个点之后的部分参与匹配。所以*.tsx有效，但*.test.tsx不会触发 —— 必须显式添加
真正麻烦的永远不是“怎么加”，而是“谁在抢跑”。每次加完记得点一下状态栏右下角的语言标识，确认显示的是你预期的类型，不是 Text 或 Auto-detected。
