如何为匹配字符串/正则的模块禁用部分Pylint检查？

一、原生配置直接实现（推荐） #

Pylint本身支持按文件路径匹配禁用指定检查，不需要额外插件。你可以在pyproject.toml（或传统的pylintrc）里用per-file-ignores配置项，完全满足你的需求：

在pyproject.toml中添加：

[tool.pylint.messages_control]
per-file-ignores = [
    # 为所有models.py文件禁用模块文档字符串检查
    "**/models.py:missing-module-docstring",
    # 可扩展其他规则，比如给utils目录下文件禁用多个检查
    "**/utils/*.py:missing-function-docstring,unused-import"
]

这个配置会让所有匹配**/models.py的文件跳过missing-module-docstring检查，比逐文件加注释高效得多。

二、按模块名匹配的进阶配置 #

如果需要针对x.y.z.models这类模块名而非文件名禁用检查，只需调整glob路径匹配规则即可：

per-file-ignores = [
    "**/*models/*.py:missing-module-docstring",
]

直接匹配模块对应的文件路径模式就能实现精准控制。

三、“两次运行方案”的可行性 #

如果因特殊限制无法使用原生配置，两次运行的方案是可行的：

• 第一次排除models.py运行全量检查：

  pylint --ignore="models.py" .
  

• 第二次仅针对models.py运行并禁用指定检查：

  pylint --disable="missing-module-docstring" $(find . -name "models.py")
  

不过这种方案需要在CI中处理两次结果的合并，VS Code里也需额外配置任务，优先级低于原生配置方案。

四、VS Code适配 #

确保VS Code的Python插件勾选了Use Project Configuration，编辑器会自动读取你的pyproject.toml配置，实时应用per-file-ignores的规则。

内容的提问来源于stack exchange，提问作者Dogweather