Pylint作为pre-commit钩子不识别--fail-under参数问题求助

问题原因 #

--fail-under 是Pylint 1.9.0及以上版本才支持的命令行选项，报错说明当前pre-commit调用的Pylint版本低于该阈值，或者系统环境里的Pylint被意外降级/切换了版本。

解决步骤 #

• 检查并升级Pylint版本
  在终端运行命令确认当前版本：

  pylint --version
  

  如果版本低于1.9.0，执行升级命令：

  pip install --upgrade pylint
  

• 替换为官方远程钩子（更稳定）
  你当前使用的local钩子依赖系统全局Pylint，易受环境变更影响。可以改用官方维护的远程钩子，它会自动隔离管理依赖版本：
  将.pre-commit-config.yaml中的Pylint配置替换为：

  - repo: https://github.com/PyCQA/pylint
    rev: v2.17.5  # 可按需选择合适的稳定版本
    hooks:
      - id: pylint
        name: pylint
        types: [python]
        args:
          [
            "-rn",
            "--rcfile=./polestar.rc",
            "--fail-under=6"
          ]
  

• 改用配置文件设置阈值（兼容旧版本）
  若不想升级Pylint，可将阈值配置移到polestar.rc文件中，添加一行：

  fail-under=6
  

  同时在pre-commit配置的args里移除"--fail-under=6"这一项。

验证 #

修改完成后，运行以下命令测试钩子是否正常：

pre-commit run pylint --all-files

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