如何避免pre-commit本地Mypy Hook重复报告同一错误？

问题根源 #

Pre-Commit默认会将匹配的文件分成多个批次传递给Hook，而Mypy是全局静态分析工具——每次调用时，它会读取项目配置并扫描整个代码库，而非仅处理传入的单个/批次文件。这就导致每个批次触发的Mypy运行都会输出同一错误，最终出现重复报告的情况。

解决方案 #

修改Pre-Commit配置，让Mypy仅运行一次并扫描指定目录，而非接收Pre-Commit传递的分批文件。具体调整如下：

修改后的.pre-commit-config.yaml配置 #

- repo: local
  hooks:
    - id: mypy
      name: mypy
      entry: mypy src/  # 替换为你的项目代码根目录，如`mypy .`表示当前目录
      language: system
      types: [python]
      pass_filenames: false  # 禁止Pre-Commit向Mypy传递文件名

配置说明 #

• pass_filenames: false：告诉Pre-Commit不要将匹配的文件列表传递给Mypy，而是直接执行我们指定的entry命令。
• entry: mypy src/：明确指定Mypy扫描的目录，确保它一次性完成全局分析，仅输出一次错误结果。

验证效果 #

运行pre-commit run mypy --all-files，此时Mypy只会执行一次，错误报告与直接运行mypy src/完全一致，不会出现重复输出。

补充说明 #

该方案完全复用本地已安装的Mypy及项目依赖，无需额外维护第三方镜像的依赖列表，适配大型项目的依赖管理需求，同时保证Mypy运行结果与原生调用一致。

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