老旧项目的静态分析之痛：报告太多，无从下手？
想象一下这样的场景：你接手了一个已经运行多年的php项目，代码量庞大，历史包袱沉重。为了提升代码质量，你决定引入强大的静态分析工具，比如phpstan或psalm。满怀期待地运行命令，结果呢？屏幕上瞬间刷出了成千上万条错误和警告，密密麻麻，令人头皮发麻。
“这个文件有200个错误，那个类有150个警告……”面对如此“洪水猛兽”般的报告，你瞬间失去了信心。要一次性修复所有问题，这简直是天方夜谭！项目还在迭代，新功能还在开发，哪有那么多时间和精力去清理这些历史遗留问题？更让人沮丧的是，这些海量的报告，反而掩盖了你刚刚提交的代码可能引入的新问题。
问题核心：如何区分“旧伤”与“新病”？
痛点很明显：我们不是不想改进，而是无法承受巨大的初始投入。我们真正关心的是，在当前这次代码提交中，我是否引入了新的 Bug 或不规范的代码？而不是项目总共有多少问题。我们需要一个机制，能够将那些“历史遗留”的问题暂时搁置，只聚焦于“增量”的改进。
这就像在体检报告中，我们希望医生能明确指出“你最近新出现的健康问题是什么”，而不是把所有历史病症都重新列一遍，让你不知所措。
救星登场：dave-liddament/sarb 助你高效管理技术债
这时候，
dave-liddament/sarb(Static Analysis Results Baselining) 这个Composer包就如同救星一般出现了。它的核心思想很简单却异常实用：为你的静态分析结果建立一个“基线”，然后只报告那些超出基线的新问题。
它能让你在不被现有海量问题压垮的情况下，逐步引入和强化静态分析流程，确保代码质量不再继续恶化，并为未来的持续改进打下基础。
SARB 的工作原理与实践
SARB 的使用流程非常直观，主要分为两步：创建基线 和 移除基线结果。
1. 安装 SARB
首先，通过 Composer 将 SARB 添加到你的项目中。通常，我们会将其作为开发依赖安装：
composer require --dev dave-liddament/sarb
如果你想在非 PHP 项目中使用 SARB，或者希望全局可用，也可以全局安装：
composer global require dave-liddament/sarb
2. 创建基线：记录“历史遗留”问题
在你决定开始使用 SARB 的那一刻，运行一次静态分析，并将所有当前报告的问题作为“基线”记录下来。这代表了你项目在某个特定 Git 提交时的所有已知问题。
例如，使用 Psalm 并将其 JSON 格式的输出通过管道传递给 SARB：
vendor/bin/psalm --output-format=json | vendor/bin/sarb create --input-format="psalm-json" psalm.baseline
这条命令会生成一个名为
psalm.baseline的文件。这个基线文件非常重要，你需要将其提交到你的版本控制系统（如 Git），与项目代码一同管理。
3. 日常使用：只看“新问题”
基线创建完成后，你就可以继续日常开发了。每次当你运行静态分析时，不再直接查看工具的原始输出，而是通过 SARB 来过滤。SARB 会对比当前的分析结果和你的基线文件，只报告那些在基线中不存在的、新引入的问题。
vendor/bin/psalm --output-format=json | vendor/bin/sarb remove psalm.baseline
现在，你的静态分析报告将变得简洁明了，只显示你最近修改可能引入的问题。这让开发者能够专注于当前的工作，确保每一次提交都不会让代码质量倒退。
4. 渐进式改进：清理“旧伤”
SARB 不仅仅是防止问题恶化，它还提供了一个优雅的机制来逐步清理历史遗留问题。通过
remove命令的
--clean-up选项，SARB 可以随机挑选出基线中的几个问题，鼓励你主动去修复它们：
vendor/bin/psalm --output-format=json | vendor/bin/sarb remove psalm.baseline --clean-up
想象一下，如果你的团队每天能修复基线中的5个问题，一年下来就能清理掉上千个！这种“积少成多”的策略，能让你在不影响开发进度的情况下，稳步降低项目的技术债务。
SARB 的强大优势与应用场景
- 专注于增量改进： 这是 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 的安装和配置都非常简单，不会给项目增加额外的复杂性。
总结：告别静态分析的“洪水猛兽”
dave-liddament/sarb彻底改变了我们在老旧项目中引入和使用静态分析工具的方式。它将一个看似不可能完成的任务——一次性修复所有问题——分解成了一个个可管理、可量化的增量改进。
不再被海量的错误报告吓退，不再为历史包袱感到沮丧。有了 SARB，你可以自信地引入静态分析，专注于你当前代码的质量，并以小步快跑的方式，逐步将你的老旧项目打磨得更加健壮和可维护。如果你正在为老项目中的静态分析结果而苦恼，不妨尝试一下 SARB，它很可能就是你一直在寻找的解决方案！
