Pylint高级配置：如何针对特定模块模式选择性禁用检查

# pyproject.toml
[tool.pylint]
ignore-patterns = [
    "models\.py$",      # 忽略所有名为 models.py 的文件
    "test_.*\.py$",     # 忽略所有以 test_ 开头的测试文件
]

# .pylintrc
[MASTER]
ignore-patterns=models.py$,test_.*.py$

# my_project/some_app/models.py
# pylint: disable=missing-module-docstring
"""
This module defines database models for the 'some_app' application.
(Pylint docstring check is disabled here as per project convention)
"""

from sqlalchemy import Column, Integer, String
from sqlalchemy.ext.declarative import declarative_base

Base = declarative_base()

class User(Base):
    __tablename__ = 'users'
    id = Column(Integer, primary_key=True)
    name = Column(String)
    email = Column(String)

    def __repr__(self):
        return f"<User(id={self.id}, name='{self.name}')>"

# pylint: enable=missing-module-docstring # 可选：在文件后续部分重新启用

#!/bin/bash

# --- 配置部分 ---
# Pylint 配置文件的位置。如果 Pylint 能够自动找到 pyproject.toml 或 .pylintrc，则无需指定。
# PYLINT_RC_OPTION="--rcfile=./.pylintrc" 

# 要禁用的特定检查，仅对匹配模式的文件生效
CHECKS_TO_DISABLE="missing-module-docstring"

# 要匹配的文件模式（这里是所有名为 models.py 的文件）
FILE_PATTERN="models.py"

# --- 文件查找与分组 ---
echo "--- 正在查找并分组Python文件 ---"

# 找到所有Python文件
# 使用 -print0 和 xargs -0 确保文件名中的空格或特殊字符能被正确处理
ALL_PYTHON_FILES=$(find . -name "*.py" -print0)

# 找到匹配特定模式的文件 (例如 models.py)
MODELS_FILES=$(find . -name "$FILE_PATTERN" -print0)

# 排除匹配模式的文件 (即其他Python文件)
# 注意：这里使用临时文件进行 comm 比较，以确保正确处理文件名列表
OTHER_PYTHON_FILES_LIST=$(mktemp)
MODELS_FILES_LIST=$(mktemp)

# 将 find 的输出转换为每行一个文件路径，并排序
echo "$ALL_PYTHON_FILES" | xargs -0 -n1 echo | sort > "$OTHER_PYTHON_FILES_LIST"
echo "$MODELS_FILES" | xargs -0 -n1 echo | sort > "$MODELS_FILES_LIST"

# 使用 comm -23 找出在 OTHER_PYTHON_FILES_LIST 中但不在 MODELS_FILES_LIST 中的文件
# comm -23 表示只显示在 FILE1 中出现而 FILE2 中没有的行
OTHER_PYTHON_FILES=$(comm -23 "$OTHER_PYTHON_FILES_LIST" "$MODELS_FILES_LIST")

# 清理临时文件
rm "$OTHER_PYTHON_FILES_LIST" "$MODELS_FILES_LIST"

# -------------------------------------------------------------------
# 第一趟：对其他Python文件运行Pylint，启用所有常规检查
echo -e "
--- 运行 Pylint (其他文件，完整检查) ---"
EXIT_CODE_PART1=0
if [ -n "$OTHER_PYTHON_FILES" ]; then # 检查文件列表是否为空
    echo "$OTHER_PYTHON_FILES" | xargs -r -d '
' pylint $PYLINT_RC_OPTION
    EXIT_CODE_PART1=$?
else
    echo "没有找到其他Python文件，跳过第一趟 Pylint 运行。"
fi
echo "Pylint 第一趟退出码: $EXIT_CODE_PART1"

# -------------------------------------------------------------------
# 第二趟：对匹配模式的文件运行Pylint，禁用特定检查
echo -e "
--- 运行 Pylint (models.py 文件，禁用 $CHECKS_TO_DISABLE) ---"
EXIT_CODE_PART2=0
if [ -n "$MODELS_FILES" ]; then # 检查文件列表是否为空
    echo "$MODELS_FILES" | xargs -r -d '
' pylint $PYLINT_RC_OPTION --disable="$CHECKS_TO_DISABLE"
    EXIT_CODE_PART2=$?
else
    echo "没有找到 $FILE_PATTERN 文件，跳过第二趟 Pylint 运行。"
fi
echo "Pylint 第二趟退出码: $EXIT_CODE_PART2"

# -------------------------------------------------------------------
# 结果合并与最终退出码
FINAL_EXIT_CODE=$((EXIT_CODE_PART1 | EXIT_CODE_PART2)) # 使用位或操作合并退出码
echo -e "
--- Pylint 最终退出码: $FINAL_EXIT_CODE ---"

# 根据最终退出码决定脚本的退出状态
exit $FINAL_EXIT_CODE