Pylint 代码审查助手

解决什么问题

Python 代码审查工具不少，但大多数要么停留在命令行输出，要么只能在 IDE 里用。当你需要在 CI 流水线里集成自动化审查、批量生成结构化报告，或者对多个项目做统一的规则裁剪时，直接调 pylint 命令行往往不够灵活。这套技能解决的就是这个问题：把 Pylint 当作一个可编程的分析引擎，而不是一个黑盒命令。

它是怎么工作的

核心思路是三层组合：

• Pylint 程序化 API：通过 Python 代码调用 Pylint，而不是走命令行，这样可以在审查前后插入自定义逻辑，比如动态调整检查规则、过滤特定告警。
• pylint-json2html 报告生成：把 Pylint 的 JSON 输出转成可视化的 HTML 报告，适合存档或分享给不直接看终端输出的团队成员。
• 自定义 checker 插件：如果内置规则不够，可以写自己的插件补充项目特定的检查项，比如团队约定的命名规范或废弃 API 使用限制。

典型的使用流程是：加载项目对应的 rcfile 配置 → 调用 Pylint API 分析目标代码 → 拿到结构化结果 → 生成 HTML 报告。

适用边界

• Pylint 是静态分析工具，不会运行你的代码，所以无法发现运行时错误，比如依赖注入失败或环境配置问题。
• 它对 Python 2/3 都有支持，但最新版主要面向 Python 3，如果项目还在用 Python 2，需要确认版本兼容性。
• 自定义插件需要自己维护，如果项目迭代频繁，插件的规则可能跟不上代码变化。
• 内置的拼写检查功能（pylint[spelling]）需要额外安装依赖，不是默认包含的。