应手动切换语法模式或配置文件关联规则：点击右下角语法名称→选PHP，或在Settings中将.php加入PHP的Registered Patterns并移除其他类型对.php的抢占注册。
文件被当成 Plain Text 或 HTML 打开怎么办
这是最常遇到的问题：双击 index.php，编辑器里没高亮、echo 不提示、str_contains() 标红——其实文件根本没走 PHP 解析器。根本原因不是“打不开”，而是 PhpStorm 把它识别成了错误的类型。
- 右键文件 → Override File Type → 选
PHP（临时生效，适合单个文件急救） - 进
Settings / Preferences → Editor → File Types，在 Recognized File Types 列表中找到PHP，确认*.php在其Registered Patterns里（没有就点+加） - 检查有没有其他类型“抢注”了
*.php：比如HTML Files或Text下也列着*.php，必须删掉——一个后缀只能归属一个类型，否则行为不可预测
怎么让 .blade.php 或 .vue 这类混合后缀走 PHP 支持
.blade.php 默认归为 Blade Template 类型，PHP 代码块被弱化处理；.vue 默认是 Vue.js Template，但 <script setup> 里的 const 和类型推导会失效。要的是 PHP 语言服务，不是模板语法糖。
- 进
File Types→ 找到PHP→ 在Registered Patterns里加*.blade.php（或*.vue） - 同时去
Blade Template（或Vue.js Template）的Registered Patterns里删掉*.blade.php（或*.vue），避免冲突 - 改完别急着写代码：关掉再重开文件，或右键 → Reload from Disk；严重时需
File → Invalidate Caches and Restart
为什么改了 File Types 还不生效
常见错觉是“点了 Apply 就完事”，其实 PhpStorm 的类型判定有缓存和索引依赖，尤其涉及解释器或语言级别变更时。
- 状态栏右下角显示
Indexing…？等它结束再测试，否则跳转、补全、类型提示全延迟 - 修改的是
PHP类型，但项目没配 PHP 解释器：进Settings → Languages & Frameworks → PHP → Interpreter，哪怕只选No interpreter，也要点一下让它激活基础支持 - 新建文件仍不对：右键目录 → New → PHP File（不是
Empty File），如果菜单里没这个选项，说明项目根目录下缺composer.json或没启用 PHP 支持
自定义后缀如 .api、.schema 怎么绑 YAML 高亮
团队内部用 .api 存 OpenAPI 3.0 文件，但 PhpStorm 默认当纯文本，连缩进折叠都失效。这不是插件问题，是文件类型没注册。
立即学习“PHP免费学习笔记（深入）”；
- 进
File Types→ 找到YAML（不是YML，后者是旧名，部分版本不识别）→ 在Registered Patterns里加*.api - 如果
YAML类型不存在，先确认是否装了YAML/Ansible Support插件（默认已启用） - 加完立刻生效：打开任意
xxx.api，右下角应显示YAML；若仍显示Plain Text，说明有别的类型（比如Text）抢先注册了该后缀，得去删
echo 是否标红，到 DateTime::createFromFormat() 能不能按住 Ctrl 跳进去，全卡在这一步。最容易被忽略的是「冲突注册」和「索引未完成」——改完设置盯着右下角看几秒，比反复重启管用。 
