如何解决老旧项目静态分析报告堆积如山的问题？dave-liddament/sarb助你高效管理技术债

可以通过一下地址学习composer：学习地址

想象一下这样的场景：你接手了一个已经运行多年的php项目，代码量庞大，历史包袱沉重。为了提升代码质量，你决定引入强大的静态分析工具，比如phpstan或psalm。满怀期待地运行命令，结果呢？屏幕上瞬间刷出了成千上万条错误和警告，密密麻麻，令人头皮发麻。

“这个文件有200个错误，那个类有150个警告……”面对如此“洪水猛兽”般的报告，你瞬间失去了信心。要一次性修复所有问题，这简直是天方夜谭！项目还在迭代，新功能还在开发，哪有那么多时间和精力去清理这些历史遗留问题？更让人沮丧的是，这些海量的报告，反而掩盖了你刚刚提交的代码可能引入的新问题。

痛点很明显：我们不是不想改进，而是无法承受巨大的初始投入。我们真正关心的是，在当前这次代码提交中，我是否引入了新的 Bug 或不规范的代码？而不是项目总共有多少问题。我们需要一个机制，能够将那些“历史遗留”的问题暂时搁置，只聚焦于“增量”的改进。

这就像在体检报告中，我们希望医生能明确指出“你最近新出现的健康问题是什么”，而不是把所有历史病症都重新列一遍，让你不知所措。

这时候，

dave-liddament/sarb

(Static Analysis Results Baselining) 这个Composer包就如同救星一般出现了。它的核心思想很简单却异常实用：为你的静态分析结果建立一个“基线”，然后只报告那些超出基线的新问题。

它能让你在不被现有海量问题压垮的情况下，逐步引入和强化静态分析流程，确保代码质量不再继续恶化，并为未来的持续改进打下基础。

SARB 的使用流程非常直观，主要分为两步：创建基线 和 移除基线结果。

首先，通过 Composer 将 SARB 添加到你的项目中。通常，我们会将其作为开发依赖安装：

<pre class="brush:php;toolbar:false;">composer require --dev dave-liddament/sarb

如果你想在非 PHP 项目中使用 SARB，或者希望全局可用，也可以全局安装：

<pre class="brush:php;toolbar:false;">composer global require dave-liddament/sarb

在你决定开始使用 SARB 的那一刻，运行一次静态分析，并将所有当前报告的问题作为“基线”记录下来。这代表了你项目在某个特定 Git 提交时的所有已知问题。

例如，使用 Psalm 并将其 JSON 格式的输出通过管道传递给 SARB：

<pre class="brush:php;toolbar:false;">vendor/bin/psalm --output-format=json | vendor/bin/sarb create --input-format="psalm-json" psalm.baseline

这条命令会生成一个名为

psalm.baseline

的文件。这个基线文件非常重要，你需要将其提交到你的版本控制系统（如 Git），与项目代码一同管理。

基线创建完成后，你就可以继续日常开发了。每次当你运行静态分析时，不再直接查看工具的原始输出，而是通过 SARB 来过滤。SARB 会对比当前的分析结果和你的基线文件，只报告那些在基线中不存在的、新引入的问题。

<pre class="brush:php;toolbar:false;">vendor/bin/psalm --output-format=json | vendor/bin/sarb remove psalm.baseline

现在，你的静态分析报告将变得简洁明了，只显示你最近修改可能引入的问题。这让开发者能够专注于当前的工作，确保每一次提交都不会让代码质量倒退。

SARB 不仅仅是防止问题恶化，它还提供了一个优雅的机制来逐步清理历史遗留问题。通过

remove

命令的

--clean-up

选项，SARB 可以随机挑选出基线中的几个问题，鼓励你主动去修复它们：

<pre class="brush:php;toolbar:false;">vendor/bin/psalm --output-format=json | vendor/bin/sarb remove psalm.baseline --clean-up

想象一下，如果你的团队每天能修复基线中的5个问题，一年下来就能清理掉上千个！这种“积少成多”的策略，能让你在不影响开发进度的情况下，稳步降低项目的技术债务。

专注于增量改进： 这是 SARB 最核心的价值。它将静态分析的焦点从“所有问题”转移到“新问题”，让团队能够有效防止代码质量进一步恶化。
兼容性强： SARB 不仅支持 PHPStan、Psalm、PHP CodeSniffer 等主流 PHP 静态分析工具，甚至可以用于任何能输出支持格式（JSON、XML等）的静态分析工具，即使是非 PHP 项目。
Git 驱动的精确追踪： SARB 巧妙地利用 Git 的版本历史来追踪代码行的变动，确保基线比较的准确性。
GitHub Actions 集成： 对于使用 GitHub Actions 的项目，SARB 提供了
```
--output-format=github
```
选项，可以直接在 Pull Request 中以批注的形式显示新引入的问题，极大地提升了 Code Review 的效率。
易于集成与轻量： 作为一个 Composer 包，SARB 的安装和配置都非常简单，不会给项目增加额外的复杂性。