如何为/tests/目录下的测试文件配置差异化Pylint校验规则

方案1：全局配置统一生效（最推荐，无需新增文件） #

Pylint 2.5及以上版本原生支持目录级别的规则禁用配置，直接在你的项目根目录pylintrc文件中添加以下内容即可：

[MASTER]
per-directory-disables =
    */tests/ : missing-module-docstring, missing-class-docstring, missing-function-docstring, protected-access

• 该配置会自动匹配所有路径中包含/tests/的Python文件，一次性禁用你指定的4项校验规则
• 原有的no-docstring-rgx配置可以直接移除，本配置已经覆盖了所有文档字符串相关的禁用需求
• 若你的Pylint版本低于2.5，先执行升级即可支持该特性：pip install --upgrade pylint

方案2：局部配置兜底（适合差异化规则需求） #

如果不同测试目录需要单独调整校验规则，可以在每个/tests/目录下新增一个.pylintrc局部配置文件，写入以下内容：

[MESSAGES CONTROL]
disable =
    missing-module-docstring,
    missing-class-docstring,
    missing-function-docstring,
    protected-access

Pylint运行时会优先读取目标文件所在目录的配置文件，优先级高于项目根目录的全局配置，可灵活实现差异化校验规则。

生效验证 #

配置修改完成后，执行以下命令即可验证规则是否正常禁用：

# 替换为任意测试文件路径
pylint tests/sample_test.py -v

查看输出的禁用规则列表，确认目标4项规则已被排除即可。

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