如何在本地系统强制启用pre-commit钩子？

以下是几种可行的方案，能自动处理pre-commit钩子的安装，或在未安装时直接阻止代码提交并给出明确提示：

1. 自定义Git钩子脚本，未安装则阻止提交 #

直接在仓库中定义pre-commit和commit-msg钩子的 fallback 逻辑，当检测到pre-commit未安装时，直接终止提交流程并给出安装指引。

步骤： #

• 在仓库根目录创建.githooks文件夹，分别创建以下两个脚本：

.githooks/pre-commit

#!/bin/bash
# 检查pre-commit是否安装
if ! command -v pre-commit &> /dev/null; then
    echo "❌ 错误：未检测到pre-commit，请先执行以下命令安装钩子："
    echo "pre-commit install --hook-type commit-msg"
    echo "pre-commit install"
    exit 1
fi
# 正常调用pre-commit钩子逻辑
exec pre-commit run --hook-stage commit "$@"

.githooks/commit-msg

#!/bin/bash
# 检查pre-commit是否安装
if ! command -v pre-commit &> /dev/null; then
    echo "❌ 错误：未检测到pre-commit，请先执行以下命令安装钩子："
    echo "pre-commit install --hook-type commit-msg"
    echo "pre-commit install"
    exit 1
fi
# 正常调用pre-commit的commit-msg校验逻辑
exec pre-commit run --hook-stage commit-msg "$@"

• 给脚本添加执行权限：

chmod +x .githooks/pre-commit .githooks/commit-msg

• 设置Git使用自定义钩子目录：

git config core.hooksPath .githooks

• 把这个配置提交到仓库，同时可以写一个简单的setup.sh脚本一键配置：

#!/bin/bash
git config core.hooksPath .githooks
echo "✅ 已设置Git钩子路径为.githooks"

这样一来，开发者如果没安装pre-commit，执行git commit时会直接报错，无法提交代码，直到安装完成。

2. 自动安装pre-commit钩子的脚本 #

利用Git的post-checkout和post-clone钩子，在开发者克隆或切换分支时自动检查并安装pre-commit钩子。

在.githooks目录下创建post-checkout和post-clone脚本：

#!/bin/bash
# 检查pre-commit是否安装
if ! command -v pre-commit &> /dev/null; then
    echo "⚠️ 提示：未检测到pre-commit，请先通过pip安装：pip install pre-commit"
    exit 1
fi

# 检查commit-msg钩子是否存在
if [ ! -f .git/hooks/commit-msg ]; then
    echo "🔧 正在安装pre-commit commit-msg钩子..."
    pre-commit install --hook-type commit-msg
fi

# 检查pre-commit钩子是否存在
if [ ! -f .git/hooks/pre-commit ]; then
    echo "🔧 正在安装pre-commit钩子..."
    pre-commit install
fi

echo "✅ pre-commit钩子已就绪"

同样给脚本加执行权限，并配置Git钩子路径。这样开发者克隆仓库或切换分支时，脚本会自动检查并安装钩子，省去手动执行命令的步骤。

3. 团队全局Git模板配置（适合统一规范） #

如果是团队协作，可以配置全局的Git初始化模板，让所有新克隆的仓库自动应用钩子配置：

1. 创建全局模板目录：

mkdir -p ~/.git-template/hooks

2. 将上述自定义的pre-commit、commit-msg、post-checkout脚本复制到~/.git-template/hooks目录，并添加执行权限。

3. 设置Git使用全局模板：

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

这样所有新克隆或初始化的仓库都会自动带上这些钩子脚本，开发者无需额外配置就能享受强制校验的能力。

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