phpcs配置失效需逐层验证：先确认命令行phpcs --version有输出，再检查PhpStorm中Code Sniffer路径、标准及本地配置文件是否正确，最后启用PHP → Quality Tools → PHP Code Sniffer validation检查项并设Scope为Project Files，修改后强制重新索引。
phpcs 配置失效、波浪线消失、检查项不触发——不是规则“丢了”，而是 PhpStorm 的两层配置（外部工具链 + 内部 Inspection）中至少有一处断了。恢复的关键不是重装，而是逐层验证。
确认 phpcs 命令行本身是否可用
IDE 不会帮你装工具，只负责调用。如果终端里都跑不通，IDE 必然失败。
- 打开终端，执行
phpcs --version，必须有输出（如3.7.2）；若报command not found，说明没装或没进 PATH - 全局安装：用
composer global require squizlabs/php_codesniffer，然后确认~/.composer/vendor/bin/（macOS/Linux）或%APPDATA%\Composer\vendor\bin\（Windows）在系统 PATH 中 - 项目内安装：路径应为
$ProjectFileDir$/vendor/bin/phpcs，且该目录下确实存在可执行文件（注意 Windows 是phpcs.bat，不是phpcs）
检查 Settings → Languages & Frameworks → PHP → Code Sniffer 三要素
这里不是“开关”，而是三个硬性绑定点，缺一不可。
-
Path to phpcs必须指向真实可执行文件，不能是目录、不能是.phar包（除非你明确配置了php前缀）、不能带空格未引号包裹（Windows 尤其注意） -
Configuration下拉菜单必须选中一个具体标准（如PSR12），仅勾选 “Enable code sniffing” 无效 - 若勾选了
Local configuration file，路径必须指向项目根目录下的phpcs.xml或phpcs.xml.dist，且该文件存在、格式合法（XML 格式正确，<rule>嵌套无误）
启用 Inspection 并确认 Scope 和缓存
即使 phpcs 路径和标准都对，如果 Inspection 没开或作用域错，编辑器照样沉默。
- 进入
Settings → Editor → Inspections → PHP → Quality Tools → PHP Code Sniffer validation，确保复选框已勾选 - 右侧
Scope必须设为Project Files（不是Default，也不是Test Sources）——否则只对新项目生效 - 改完设置后，按
Ctrl + Shift + O（Windows/Linux）或Cmd + Shift + O（macOS）强制重新索引当前文件；整项目异常则执行File → Reload project from Disk
为什么 PSR12 不报 @return 缺失？规则没补全
PSR12 只定义结构，不包含文档块校验。这类提示由 Squiz.Commenting.FunctionComment 等子规则控制，IDE 不会自动加载。
立即学习“PHP免费学习笔记（深入）”；
- 在项目根目录的
phpcs.xml中，不能只写<rule ref="PSR12"/>，必须显式追加：<rule ref="Squiz.Commenting.FunctionComment"/> - 或运行命令行验证：
phpcs --standard=PSR12 --sniffs=Squiz.Commenting.FunctionComment src/MyClass.php，只有命令行能触发，IDE 才可能显示 - 别依赖界面下拉菜单里的 “PSR12” 文字——它只是个名字，背后没规则，就等于没装
phpcs 输出之间靠标准格式桥接，一旦 phpcs 版本升级（比如从 3.x 升到 4.x），输出字段可能变化，导致 IDE 解析失败——此时波浪线全无，但命令行仍正常。这种兼容性断裂不会报错，只会静默失效。 
