首页/开发/Git 与协作速查/core.hooksPath 统一管理钩子
进阶与大仓实践69 条

core.hooksPath 统一管理钩子

把钩子目录指向仓库内的 .githooks,使钩子可提交、可评审;New 版本 Git 支持,切换后 .git/hooks 不再生效。

Git 与协作速查开发更新于 2026-10-12
配置git config core.hooksPath .githooks
目录约定.githooks/ 入库并给文件加可执行位
注意每位成员需各自执行一次配置;也可用仓库级模板方案

常用示例

常用示例
mkdir -p .githooks
git config core.hooksPath .githooks
printf '#!/bin/sh\necho check\n' > .githooks/pre-commit
chmod +x .githooks/pre-commit
若钩子做本地检查,注意它们对 CI 的补充作用而非替代:CI 才是统一门禁。

易错点

  • Windows 上可执行位与换行符问题会让钩子静默失效,改完先手工执行验证
  • core.hooksPath 会覆盖默认钩子目录,某些工具安装的默认钩子会随之失效

数据来源与参考

  • Git 官方文档:githooks(core.hooksPath)
  • Git 官方文档:git-config
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌