PHP_CodeSniffer需配合插件在PhpStorm中实现代码规范检查，MetricsReloaded提供轻量级文件级度量，phploc补全项目级统计，但所有工具均无法识别逻辑坏味道。
PHP_CodeSniffer 配合插件做静态分析
PhpStorm 本身不内置完整 PHP 代码规范检查，得靠 PHP_CodeSniffer（简称 PHPCS）配合插件落地。直接装官方插件 “PHP Code Sniffer” 就行，但注意它只是个“胶水”——真正干活的是你本地装的 phpcs 命令。
常见错误现象：PHP_CodeSniffer executable not found 或检查结果为空。根本原因是插件没找到可执行文件路径，不是插件没启用。
- 确保已用
composer global require squizlabs/php_codesniffer安装，或通过 phar 方式部署 - 在 PhpStorm → Settings → Languages & Frameworks → PHP → Code Sniffer，点 “…” 找到
phpcs可执行文件（如~/.composer/vendor/bin/phpcs或C:\Users\X\AppData\Roaming\Composer\vendor\bin\phpcs.bat） - 选好标准（
PSR12、PSR2或自定义ruleset.xml），别用默认的PEAR，太宽松 - 勾选 “Show warnings as” → “Info”，否则低危问题直接被忽略
MetricsReloaded 插件跑基础代码度量
想看圈复杂度、类长度、方法参数个数这些基础指标？MetricsReloaded 是目前 PhpStorm 上最轻量、最稳定的选项。它不依赖外部工具，纯 IDE 内部分析，适合日常快速扫描。
使用场景：重构前摸底、Code Review 时快速定位“可疑大类”或“嵌套过深的方法”。但它不支持导出报告，也不能聚合项目级统计。
立即学习“PHP免费学习笔记（深入）”；
- 安装后需手动启用：Settings → Editor → Inspections → MetricsReloaded，把想要的指标（如
Method length、Cyclomatic complexity）打钩 - 阈值要调低：默认
Method length > 50才报警，建议改成25；Cyclomatic complexity > 10改成6，更符合现代 PHP 实践 - 注意它只分析打开的文件或当前模块，不会全项目扫描——想看整体分布，得用外部工具（见下一条）
用 PHPLOC 命令行工具补全项目级统计
PhpStorm 插件再强，也搞不定“整个 vendor 之外的代码总行数”“测试覆盖率占比”这类聚合需求。phploc 是唯一能稳稳输出结构化统计的 CLI 工具，和 PhpStorm 是互补关系，不是替代关系。
性能影响小，10 万行代码通常 2 秒内完成；但要注意它默认包含注释和空行，和 IDE 内部统计口径不一致，别直接对比数字。
- 装法：
composer global require phploc/phploc - 常用命令：
phploc --exclude vendor,tests src/（排除 vendor 和 tests 目录，只算 src） - 关键字段解释：
Lines of Code (LOC)是总行数，Logical Lines of Code (LLOC)才是有效逻辑行，后者更值得盯 - 想集成进 PhpStorm？在 Tools → External Tools 里加个配置：Program 填
phploc，Arguments 填--exclude vendor,tests $ProjectFileDir$/src，运行后结果在 Terminal 面板里看
别指望插件自动识别“坏味道”逻辑
所有现有插件（包括付费的 PHP Insights IDEA 版）都只能检测语法层面或规则定义的模式，比如“if 嵌套超 4 层”或“方法参数超 5 个”。它们完全无法判断“这个 switch 本该用策略模式替换”或“这个 DTO 正在承担太多职责”。
容易被忽略的地方：团队常把“插件没报错”等同于“代码质量 OK”，其实最危险的坏味道恰恰是静态工具看不见的——比如领域逻辑散落在 Service 和 Controller 之间、状态变更没有封装、异常处理全用 try/catch 吞掉。这类问题只能靠人盯、靠测试覆盖、靠定期结对重构。
