pre-commit脚本不执行的首要原因是缺少可执行权限,需运行chmod +x .git/hooks/pre-commit(Linux/macOS/WSL)或用Git Bash处理Windows换行符;Husky 9.0需同时确保.git/hooks/pre-commit代理脚本和.husky/pre-commit文件均具可执行权。

pre-commit 脚本不执行?先看 chmod +x
Git 只会执行 .git/hooks/ 下具有可执行权限的脚本,哪怕内容完全正确,没加权限就等于没写。常见现象是:改完 pre-commit 脚本、保存、git commit,结果什么都没触发,控制台静悄悄。
- Linux/macOS 必须运行:
chmod +x .git/hooks/pre-commit - Windows(WSL)同上;纯 CMD/PowerShell 不支持直接 chmod,得用 Git Bash 或 WSL 执行权限设置
- 别只改文件内容就以为完事——权限是独立属性,
git add或git commit都不会自动补权限 - 检查是否生效:
ls -l .git/hooks/pre-commit,输出中应含-rwxr-xr-x(至少当前用户有 x)
Husky 9.0 下的权限问题更隐蔽
Husky 9.0 把钩子移到 .husky/ 目录,但 Git 本身并不直接读那里——它靠 husky install 在 .git/hooks/ 下生成代理脚本(如 .git/hooks/pre-commit),再由这些代理调用 .husky/ 里的实际逻辑。所以权限问题分两层:
-
.git/hooks/pre-commit这个代理脚本必须有执行权(husky install通常会自动设好,但手动覆盖后可能丢失) -
.husky/pre-commit本身也要可执行,否则代理调用时会报Permission denied - Windows 用户容易踩坑:用记事本或 VS Code 直接编辑
.husky/pre-commit后,行尾符变成CRLF,bash 解释器无法识别,表现为“bad interpreter”错误——用dos2unix .husky/pre-commit或在编辑器里切为 LF 模式
跨平台团队怎么统一权限?
手动 chmod 不适合协作项目,尤其当成员用不同系统时。真正可靠的方案不是靠人记命令,而是让 Git 自己管:
使用 gitlab-ci-local 解析器和 YAML AST 转换来将 GitLab CI .gitlab-ci.yml 流水线转换为 GitHub Actions 工作流程。将 GitLab 阶段、服务和构件映射到等效的 GitHub Actions 语法。
- 用
git config core.hooksPath .husky(Husky 9+ 默认启用),把钩子根目录重定向到.husky,避免依赖.git/hooks/的权限状态 - 在 CI 或初始化脚本里加一句:
find .husky -type f -exec chmod +x {} \;,确保所有钩子文件权限一致 - Node 项目可借助
preparescript:"prepare": "husky install && chmod +x .husky/*",npm install后自动修复 - 别把
.git/hooks/提交进仓库——它不随 clone 自动复制,且不同系统权限行为不一致,反而制造混乱
为什么 post-merge 脚本常因权限失败?
post-merge 触发时机特殊:它在 Git 内部完成合并后立即运行,此时工作区文件状态刚更新,但脚本自身可能被 Git 从模板复制而来(比如用 git init 初始化时),复制过程不保留执行位。
- 现象:
git pull后报错.git/hooks/post-merge: Permission denied - 根本原因:Git 复制
.git/hooks/post-merge.sample时生成的是普通文件,不是可执行文件 - 解决:删掉
.git/hooks/post-merge,重新软链接或复制并立刻chmod +x;或者改用 Husky 管理,避开原生 hooks 目录的复制陷阱 - 注意:
post-merge常用于npm install或make clean,一旦失败,后续命令全卡住,比 pre-commit 更容易引发连锁阻塞
权限这事看着简单,但实际发生在 Git 内部调度、跨平台解释器、团队协作路径多个断点上。最麻烦的不是设一次权限,而是某次 git reset --hard 或重装 husky 后,那个被遗忘的 .husky/pre-push 文件又变回了 -rw-r--r--。










