Pylint 基线管理器

问题：历史代码如何渐进式治理？

团队在迭代中常面临一个矛盾——想用 pylint 逐步提升代码质量，但存量违规项会瞬间淹没新增问题的告警。一次性修复所有历史问题成本过高，而单纯忽略全部告警又会让新引入的代码问题彻底失管。

工作原理：基线文件的生成与维护流程

• 精准标记存量问题：通过 pylint --output-format=json 获取结构化分析结果，自动识别并记录当前代码库中已存在的违规项，形成初始基线快照。
• 提交后增量追踪：每次代码提交后，技能会重新运行 pylint，对比新结果与基线文件，仅对未在基线中登记的新违规项触发告警，实现“旧问题静默、新问题显形”的动态平衡。
• 基线更新机制：当开发者修复部分存量问题时，可通过调整基线文件主动移除对应条目，推动基线持续收敛，最终实现代码质量的阶梯式提升。

适用边界与关键注意点

• 基线文件需定期维护：基线文件本质是“已知问题白名单”，长期不更新会导致大量应修复的旧问题被持续抑制，需结合代码重构计划定期清理。
• 依赖 Pylint 版本兼容性：基线文件的格式与 pylint 版本强相关，升级 Pylint 时需验证基线文件兼容性，避免因版本差异导致新违规项误判。