如何为本地机器配置通用pre-commit钩子并兼容项目自有配置？

当然有办法实现你的需求——pre-commit支持全局配置文件，既能存放通用钩子，又能兼容项目自有配置，具体操作如下：

1. 创建全局pre-commit配置文件 #

你可以在以下任一位置创建全局配置文件：

• 常规路径：~/.pre-commit-config.yaml
• 遵循XDG规范的路径：$XDG_CONFIG_HOME/pre-commit/config.yaml（若未设置XDG_CONFIG_HOME，默认路径为~/.config/pre-commit/config.yaml）

以下是包含你所需钩子的示例配置，可根据实际情况修改：

repos:
  # 阻止直接提交到main/master分支
  - repo: local
    hooks:
      - id: block-main-master-commits
        name: Block commits to main/master
        entry: bash -c 'current_branch=$(git rev-parse --abbrev-ref HEAD); if [[ "$current_branch" =~ ^(main|master)$ ]]; then echo "❌ 禁止直接提交到main/master分支"; exit 1; fi'
        language: system
        stages: [commit]

  # 检查Git身份是否匹配项目类型（个人/工作）
  - repo: local
    hooks:
      - id: check-git-identity
        name: Validate Git identity
        entry: bash -c '
          git_email=$(git config user.email)
          # 根据项目路径区分工作/个人仓库，自行修改路径和邮箱
          if [[ "$PWD" == *"/work/repos/"* && "$git_email" != "your-work@company.com" ]]; then
            echo "❌ 工作仓库需使用工作邮箱提交"
            exit 1
          fi
          if [[ "$PWD" != *"/work/repos/"* && "$git_email" != "your-personal@example.com" ]]; then
            echo "❌ 个人仓库需使用个人邮箱提交"
            exit 1
          fi
        '
        language: system
        stages: [commit]

  # 强制提交必须签名
  - repo: local
    hooks:
      - id: require-signed-commits
        name: Require signed commits
        entry: bash -c 'if ! git verify-commit HEAD --quiet; then echo "❌ 提交未签名，请先配置Git签名"; exit 1; fi'
        language: system
        stages: [commit]

2. 让全局钩子自动生效 #

方案一：配置Git模板目录（推荐，新仓库自动生效） #

这个方法能让所有新克隆或初始化的Git仓库自动加载全局钩子：

1. 创建Git模板目录：

   mkdir -p ~/.git-template/hooks
   

2. 设置Git全局模板路径：

   git config --global init.templateDir ~/.git-template
   

3. 在模板目录中安装全局pre-commit钩子：

   pre-commit install --config ~/.pre-commit-config.yaml --hook-dir ~/.git-template/hooks
   

方案二：为现有仓库手动添加全局钩子 #

对于已经存在的仓库，进入仓库根目录后运行：

pre-commit install --config ~/.pre-commit-config.yaml

3. 兼容项目自有配置 #

当项目本身有.pre-commit-config.yaml时，你可以让全局钩子和本地钩子同时运行：
进入项目目录后，运行以下命令安装双配置钩子：

pre-commit install --config ~/.pre-commit-config.yaml --config .pre-commit-config.yaml

这样pre-commit会依次加载全局和本地配置中的所有钩子，不会出现冲突。

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