本地Python编写的pre-commit钩子应选用哪种language配置？

核心差异 #

• 环境隔离性

  • language: python：pre-commit会自动创建独立虚拟环境（可通过配置指定Python版本），钩子的依赖会被安装到这个专属环境里执行。不管你本地有没有对应包，只要钩子声明了依赖，pre-commit会自动处理。
  • language: system：直接用当前shell环境的Python解释器跑脚本，完全依赖当前环境的包和PATH配置，没有任何隔离。

• 依赖管理逻辑

  • language: python：本地钩子确实不需要整个仓库可pip install .，但如果钩子用到第三方库（比如requests、pytest），只要在requirements.txt或pyproject.toml里声明，pre-commit会自动把依赖装到虚拟环境，不用用户手动操作。
  • language: system：所有依赖必须提前在用户本地环境装好，pre-commit不会帮你处理任何依赖安装。

• 解释器选择逻辑

  • language: python：pre-commit会主动查找系统里的Python解释器（比如你通过default_language_version指定的版本），哪怕PATH里没显式的python命令，只要系统存在对应版本，它就能找到——你在nix-shell里能运行，就是因为pre-commit感知到了shell临时注入的Python路径。
  • language: system：完全看脚本的shebang（比如#!/usr/bin/env python）和当前shell的PATH，必须确保PATH里有对应的Python解释器才能运行。

选型建议 #

优先选language: python，原因很直接：

• 执行环境稳定，不会因为用户本地Python版本、包版本不一样导致钩子跑崩，团队协作时尤其有用。
• 依赖管理省心，不用反复提醒同事装各种依赖。
• 哪怕是本地钩子，未来如果要改成共享钩子，迁移成本极低。

只有在以下场景考虑language: system：

• 钩子是极简脚本，完全不需要第三方依赖，且你能确保所有使用者的环境一致。
• 钩子必须调用当前环境里的特定工具（比如系统全局安装的某个CLI），不能用隔离环境。

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