pylint

项目概述

Pylint 是 Python 静态代码分析器，在不运行代码的情况下分析源码，检查错误、强制编码规范、发现代码坏味道并给出重构建议。它基于内部代码表示 astroid 做类型推断，即使代码没有完整类型标注也能发现更多问题。Pylint 高度可配置，支持插件扩展自定义检查，并附带 pyreverse 类图生成器与 symilar 重复代码查找器。

不跑代码也能查出错误与坏味道的深度检查器。

主要功能

• 错误检查：不运行代码即可发现潜在错误
• 规范强制：按编码标准强制执行团队规范
• 坏味道检测：识别重复代码、过长函数等代码坏味道
• 类型推断：基于 astroid 推断实际值，无完整类型标注也能检查
• 重构建议：对代码改进给出可操作建议
• 插件生态：支持自定义插件与 pylint-django 等现成插件
• 附带工具：内置 pyreverse 类图生成与 symilar 重复代码检测
• 高度可配置：检查项可逐条启用或禁用

适用人群

• Python 开发者
• 遗留项目维护者
• 代码质量负责人
• 开源项目维护者
• 需要深度静态分析的技术团队

快速上手

1. 安装 Pylint

pip install pylint

2. 检查单个文件或项目

pylint mymodule.py

3. 遗留项目建议先只看错误

pylint --errors-only mymodule.py

4. 按需在配置中逐步启用更多检查类别

核心优势

• 推断能力强：不依赖完整类型标注也能发现深层次问题
• 检查更全面：比多数 linter 覆盖更多检查项
• 可扩展：插件机制支持为内部库编写专属检查

系统要求

注意事项

• 渐进采用：老项目建议先用 --errors-only，再逐步放开检查
• 速度权衡：深度推断带来更慢的速度，可与 ruff 等快速工具互补使用
• 第三方库：部分第三方库需安装对应 pylint 插件才能完整支持