code > inspect code 是 phpstorm 代码审查的核心入口,用于触发本地规则扫描并生成质量基线;它不替代人工评审,需配合 space 插件实现带评论、状态跟踪的协作评审。

Code > Inspect Code 是核心入口,不是“Review”菜单
PhpStorm 没有独立的「代码评审」主菜单项,所有基于 IDE 内置能力的静态检查都走 Code > Inspect Code。这个操作触发的是本地、实时、基于项目配置的规则扫描,和 Git 提交或分支对比无关——它不替代 Code Review 流程,而是为评审提供可量化的质量基线。
常见错误是误点 Analyze > Code Cleanup 或在右键菜单里找“Review”,结果只做了格式化,没跑规则检查;也有人在 Settings > Editor > Inspections 里勾了一堆 PHP 项,却没在 Inspect Code 对话框中选中对应 profile,导致检查静默失效。
- 必须手动打开一个 PHP 文件(或选中某段代码),再执行
Code > Inspect Code,否则范围默认为整个 project,耗时且干扰大 - 首次使用前,确认
Settings > Editor > Inspections > PHP下至少启用了Unused symbol、Undefined variable、Missing type declaration这三类高价值检查项 - 检查结果面板里的「Severity」列比「Problem」描述更关键:标为
Error的问题建议阻断提交,Warning可标记为待讨论,Info级别慎用,容易淹没重点
Space 插件才是真团队协作评审,但需显式启用
内置的 Code > Inspect Code 不支持评论、@同事、状态跟踪——这些必须靠 Space 插件。它不是默认安装的,也不是 JetBrains 官方插件市场里搜“review”能直接找到的,得手动开启。
容易踩的坑:装了插件但没登录 Space 账户,或没配置 Git Remote,会导致右键 Space | Create Code Review 灰掉;还有人创建后发现评论发不出去,其实是 Space 服务端没开「Code Review」模块权限。
- 安装路径:
Settings > Plugins > Marketplace,搜索Space,安装并重启 PhpStorm - 首次启用需登录 JetBrains Account,并绑定组织内的 Space 实例(URL 通常形如
https://your-org.jetbrains.space) - Git 仓库必须已配置 remote(
git remote add origin ...),否则无法关联 commit 或 branch - 创建评审时,右键 commit 选
Space | Create Code Review,比手动填分支更可靠——它自动带出变更文件列表和 diff,避免漏审
PHP_CodeSniffer 类插件不能替代 Space,但能统一评审标准
像 PHP Code Sniffer、PHPStan 这类插件,本质是把命令行工具包装进 IDE,它们输出的是机器可读的违规报告,不是人类可讨论的评审上下文。强行用它们做「团队评审」,只会变成每人对着同一份 phpcs.xml 报错截图各自改,失去同步反馈价值。
性能影响常被低估:如果在 Settings > Languages & Frameworks > PHP > Quality Tools 里同时启用了 phpcs、phpstan、psalm 三者,并勾选了「Run on the fly」,1000 行文件编辑时 CPU 占用可能飙到 90%,卡顿感明显。
- 只在
Inspect Code时启用其中 1–2 个主力工具(比如phpcs做风格 +phpstan做类型),禁用「On the fly」,改完再手动扫一次 - 规则集必须和团队
phpcs.xml文件一致,别在 IDE 里选 PSR12,而项目实际用的是自定义的MyCompanyStandard,否则评审时争议点全在 IDE 配置差异上 -
phpcbf自动修复要慎用:它可能把array()改成[],但项目 PHP 版本还停留在 5.4,这种「正确但不兼容」的修复会引发 runtime 错误
评审结果导出和交接,别依赖截图
很多人评审完直接截 Inspection Results 面板图发钉钉,问题在于:截图无法跳转到源码位置、不能复现上下文、也不带修复建议。下次别人看图时,得重新打开文件、滚动查找、再猜你指哪一行。
真正可交接的方式是生成结构化报告,但 PhpStorm 默认不提供 HTML 导出——得靠命令行补位。
- 用终端执行:
phpcs --report=html --report-file=review-report.html --standard=PSR12 src/,生成带链接的 HTML 报告,发给同事可直接点击跳转 - Space 创建的评审链接(形如
https://your-org.jetbrains.space/p/xxx/cr/123)才是唯一具备完整上下文的交付物:含 commit hash、diff、评论时间线、已解决/未解决状态 - 禁止把
.idea/inspectionProfiles/下的 XML 文件当「评审标准」共享——它只存 IDE 配置,不含规则逻辑,队友导入后大概率报错「Unknown inspection ID」
Space 登录态是否稳定、phpcs 规则集是否和 CI 一致、以及每个人是否理解「Inspect Code 是准备动作,Create Code Review 才是协作起点」。php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










