Pylint所有文件同一行报不存在的导入顺序错误如何排查?
问题根因
该问题是Pylint旧版本bug + 第三方Pylint插件不规范实现共同导致的:
- 你使用的pylint 2.8.3属于旧版本,其导入顺序检查逻辑存在缺陷,会把Pylint插件初始化阶段执行的导入代码,误计入当前被检查的用户文件的导入列表中
- 你加载的
pylint_flask/pylint_flask_sqlalchemy插件的旧版本,初始化代码里确实包含from astroid import MANAGER这行导入,这段代码不会出现在你的自有项目文件里,是插件运行时动态执行的
排查步骤
- 先验证插件关联:注释掉VS Code配置中
python.linting.pylintArgs里的--load-plugins及后面的两个插件参数,重启VS Code Python语言服务后查看警告是否消失。如果警告消失即可确认是加载的插件触发的问题 - 定位具体问题插件:分别单独加载
pylint_flask、pylint_flask_sqlalchemy,测试加载哪个插件时会复现警告,即可锁定问题来源
解决方法
- 优先升级组件:将Pylint升级到2.10及以上版本,同步升级astroid到匹配版本,新版本Pylint已经修复了插件导入计入用户文件检查的bug,从根源解决问题。如果你的Python 3.8环境支持该版本范围,推荐使用该方案
- 规则规避:如果不想升级版本,可以在
python.linting.pylintArgs中添加参数--disable=wrong-import-order全局关闭该检查;或者创建.pylintrc配置文件,在[import]段添加known_third_party=astroid,明确标注astroid为第三方库,导入顺序优先级低于标准库re,即可消除误报 - 插件替换:如果确认是某款Flask相关Pylint插件导致,可以替换为当前仍在维护的同类型插件,避免类似问题
内容的提问来源于stack exchange,提问作者vianmixt
相关产品推荐
相关产品推荐

