PhpStorm需集成本地phpcs才能实现实时代码规范检查：先全局或项目安装phpcs并配置PATH，再在Settings→Languages & Frameworks→PHP→Code Sniffer中正确设置phpcs路径、显式指定标准（如PSR12）并补充子规则（如Squiz.Commenting.FunctionComment），同时将Inspection的Scope设为Project Files并禁用缓存。
PhpStorm 本身不自带 PHP 代码规范检查能力，必须把本地安装的 phpcs（PHP_CodeSniffer）或 phpmd 注册为外部质量工具，并绑定到 Inspection 系统，才能在编辑器里实时看到波浪线和快速修复。
确认本地 phpcs 是否可用
IDE 不会帮你装工具，只负责调用。先确保终端能跑通命令：
- 执行
phpcs --version，有输出版本号（如3.7.2）才算就绪 - 若报
command not found，用composer global require squizlabs/php_codesniffer安装，或进项目目录运行composer require --dev squizlabs/php_codesniffer - 路径要填对：全局安装通常在
~/.composer/vendor/bin/phpcs（macOS/Linux）或%APPDATA%\Composer\vendor\bin\phpcs.bat（Windows）；项目内安装则是$ProjectFileDir$/vendor/bin/phpcs
在 Settings 里配置 PHP_CodeSniffer
路径是 Settings → Languages & Frameworks → PHP → Code Sniffer，这里不是“启用开关”，而是三个硬性绑定点：
-
Path to phpcs必须指向可执行文件，不能留空或填错路径 -
Configuration下拉菜单必须选中具体标准（如PSR12），仅勾选 “Enable code sniffing” 没用 - 如果选了
Local configuration file，必须指向项目根目录下的phpcs.xml或phpcs.xml.dist，且该文件需存在并格式正确
为什么开了 PSR12 还不报 @return 缺失？
PSR12 标准本身不包含文档块（docblock）校验规则，@return、@param 类提示由 Squiz.Commenting.FunctionComment 等 sniff 控制，它们默认不启用。
立即学习“PHP免费学习笔记（深入）”；
- 在
phpcs.xml中不能只写<rule ref="PSR12"/>，得显式追加：<rule ref="Squiz.Commenting.FunctionComment"/> - 或者用命令行验证：运行
phpcs --standard=PSR12 --sniffs=Squiz.Commenting.FunctionComment src/MyClass.php，看是否触发——只有命令行能跑出，IDE 才可能显示 - PhpStorm 不会自动加载子规则，界面里看到的“PSR12”只是骨架，没补全规则名，它就不工作
实时提示没反应？检查 Scope 和缓存
常见现象是改完设置、保存文件、甚至重启 IDE，依然没波浪线。核心卡点在两个地方：
- 在 Settings → Editor → Inspections → PHP → PHP Code Sniffer validation 页面，确认
Scope是Project Files，不是Current File（后者只扫当前打开的文件） - 勾掉底部的
Use cache选项——旧缓存常导致漏检，禁用后首次扫描稍慢，但结果可靠 - 如果整项目异常，执行 File → Reload project from Disk，或手动删掉
.idea/misc.xml里的inspectionProfiles节点再重启
最易被忽略的是：PHP_CodeSniffer 的规则集和 PhpStorm 的 Inspection 是两套系统，前者管“代码是否符合规范”，后者管“要不要在编辑器里标出来”。中间缺任何一环——路径错、规则名漏、Scope 错、缓存脏——都会断掉实时反馈链。
