pylint-django:Django 项目写多了,你需要一个懂 Django 的代码检查工具
写 Django 项目的人,大多用过 Pylint。但 Pylint 不认识 Django 那一套写法。Model.objects 会报错,Views.request 会报错,ForeignKey 属性也会报未定义。每次跑检查,满屏都是框架本身的警告,真正的问题反倒被淹没了。
pylint-django 就是解决这个问题的插件。装上它,Pylint 就能理解 Django 的写法,不再对框架自带的属性报假阳性。

安装和配置
安装很简单,pip 直接装:
pip install pylint-django
它不会自动安装 Django。大部分项目已经有自己的 Django 环境,强行再装一份反而容易冲突。需要的话可以加 [with-django] 后缀。
使用方式有两种。通过环境变量指定 Django 配置:
DJANGO_SETTINGS_MODULE=your.app.settings pylint --load-plugins pylint_django
另一种是命令行直接传参:
pylint --load-plugins pylint_django --django-settings-module=your.app.settings
不配置 settings 也能用,Pylint 会用默认配置运行。但指定了 settings 模块后,类型推断会更准确,尤其是 INSTALLED_APPS 里的应用能被正确识别。
如果用 Prospector 做统一代码检查,它会自动检测项目里有没有 Django,有就直接激活 pylint-django,不用额外配置。

实际功能
核心能力是消除 Django 相关的误报。Model.objects 不会报错,View 和 Form 的属性不会提示未定义,Meta 内部类不会误判,Model.__unicode__ 方法也能正确验证。每个 Django 开发者都遇到过这些假阳性,这个插件一次性解决。
它还附带迁移检查插件,专门扫描数据库迁移文件。能发现两类常见问题:一是给已有表加字段时带了默认值,这对大表性能有影响;二是 RunPython 迁移没有提供回滚函数,导致数据迁移不可逆。这个迁移插件默认不开启,需要手动加载:
pylint --load-plugins pylint_django --load-plugins pylint_django.checkers.migrations
适用场景
项目目前 622 个 Star,不算大热项目,但在 Django 生态里是标配。核心功能成熟稳定,issue 响应及时,社区维护积极。
最适合的场景是已有一定规模的 Django 项目。项目越大,代码文件越多,lint 检查的报错量就越大。没有这个插件时,团队成员每天要在几百条 Pylint 警告中翻找真正的问题。装上之后,Django 相关的误报全部过滤掉,报错列表里留下的才值得仔细看。
对于新项目,从一开始就把 pylint-django 加入 CI 流程,能避免后续积累大量 Django 样板的 lint 噪声。装上一分钟就能配好,省下来的时间是长期的。
流程,能避免后续积累大量 Django 样板的 lint 噪声。装上一分钟就能配好,省下来的时间是长期的。
729



被折叠的 条评论
为什么被折叠?



