用途:Codacy Code Review 用于在现有代码审查流程(如 code-review 技能、CodeRabbit、人工审查)之上叠加 Codacy 数据,覆盖质量问题、安全发现、覆盖率和重复度。
主要能力:区分本地与云端两种分析来源。本地 Analysis CLI 即时检测 PR 变更上的问题与安全发现,无需推送;云端 Cloud CLI 提供覆盖率增量、质量门状态、重复度以及问题管理(忽略/取消忽略)。云端数据始终对应 PR 的最新推送(HEAD 提交)。
必要用法:需安装 codacy-analysis(本地)与 codacy(云端)两个 CLI,二者共享 ~/.codacy/credentials 凭据,一次登录即可。本地分析命令:codacy-analysis analyze --pr --fail-if-missing --output-format json;PR 尚未创建时用 --diff 代替 --pr。云端命令:codacy pull-request <provider> <org> <repo> <prNumber>,加 --diff 可查看带行内覆盖率标注的差异。重新分析可加 --reanalyze-and-wait(最长阻塞 20 分钟,每 10 秒轮询)或 --reanalyze。忽略问题:--ignore-issue <issueId> --ignore-reason FalsePositive、--ignore-all-false-positives,取消用 --unignore-issue <issueId>。
适用场景:审查 PR 时按八步流程执行——收集 PR 上下文、本地分析变更、获取云端数据、检查引入的问题、检查覆盖率、核对与工单/描述的一致性、提出测试计划、汇总改进建议。
限制:--fail-if-missing 很重要,否则不可用的扫描器会被静默跳过并仍以 0 退出,导致“未引入问题”的误判。本地 CLI 可能不支持云端全部工具,必要时需标注部分发现仅见于云端。忽略问题仅在云端生效且即时生效,其他配置变更需下次远程分析后才应用。若云端分析过时或缺失,可触发重新分析。