如何配置pre-commit+pylint仅因E/F类问题失败且保留警告

问题根源 #

你遇到的--fail-on参数不生效，主要是两个原因：

• pylint版本过低：--fail-on是pylint 2.12.0及以后才新增的参数，旧版本不支持该功能
• 参数设置不完整：你只指定了E，但没包含需要触发失败的F（致命错误），且多值参数需要正确枚举格式

解决方案 #

按以下步骤调整配置：

1. 升级pylint到支持版本
   执行命令升级：

   pip install --upgrade pylint
   

   验证版本：

   pylint --version
   

   确保版本≥2.12.0

2. 修改pre-commit钩子配置
   调整args参数，同时指定E和F，确保仅这两类问题触发钩子失败，同时保留所有警告输出：

   - repo: local
     hooks:
       - id: pylint
         name: pylint
         entry: py -m pylint
         language: system
         types: [python]
         args: [--fail-on=E,F]
   

3. 检查并覆盖pylintrc配置（如果有）
   如果你本地有pylintrc或.pylintrc配置文件，检查是否存在fail_on选项。如果有，要么删除该配置项，要么保持命令行参数的优先级（命令行参数会覆盖配置文件设置）。

验证效果 #

提交代码时，pylint会正常输出C、R、W类警告，但只有当代码中出现E（错误）或F（致命错误）时，pre-commit钩子才会失败，完全符合你的需求。

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