如何使用Pylint仅检查Python项目中变更的代码行

你当前使用的命令只会筛选出变更过的Python文件，传入Pylint后会对文件全量执行检查，自然会输出所有报错。可以通过以下两种方式实现仅检查变更行：

方案一：使用diff-quality工具（推荐） #

这是渐进式代码检查的常用方案，不需要手动处理行号过滤逻辑：

1. 安装依赖包
   pip install diff_cover
2. 执行检查，默认会对比当前工作区与主分支的差异，仅输出变更行的Pylint错误
   diff-quality --violations=pylint --compare-branch=main

若要对比其他分支，将main替换为对应的分支名即可，也支持对比单次提交的差异。

方案二：自定义Shell脚本过滤（无额外依赖） #

如果不想安装第三方工具，可以自己实现行号匹配逻辑，脚本示例如下：

# 筛选所有变更的Python文件
changed_py_files=$(git diff --name-only --diff-filter=d | grep -E '\.py$')
if [ -z "$changed_py_files" ]; then
  echo "无Python变更文件，退出检查"
  exit 0
fi

# 生成全量Pylint检查结果，使用可解析格式输出
pylint --output-format=parseable $changed_py_files > pylint_full.tmp

# 逐文件过滤变更行的错误
for file in $changed_py_files; do
  # 提取当前文件所有变更的行号
  changed_lines=$(git diff --unified=0 $file | grep -E '^@@' | awk -F'[ +,]' '{for(i=0;i<$4;i++) print $3+i}')
  # 匹配对应行号的错误
  for line in $changed_lines; do
    grep "^$file:$line:" pylint_full.tmp
  done
done

# 清理临时文件
rm pylint_full.tmp

注意事项 #

• 脚本默认对比的是当前工作区未提交的变更，如果要对比远端分支，将git diff命令替换为git diff origin/main --即可
• 两种方案都只会检查新增、修改的代码行，已删除的代码行不会纳入校验范围
• 可以直接在原Pylint命令中追加自定义规则参数，比如指定配置文件--rcfile=.pylintrc，不会影响过滤逻辑

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