pre-push钩子须置于.git/hooks/pre-push，命名无后缀且需chmod+x；go测试应限定包范围、显式设goos/goarch、避免重定向stderr；失败时用|| exit 1传递退出码；团队需文档化安装步骤并依赖ci冗余校验。
pre-push 钩子该放哪、怎么命名才生效
Git 的 pre-push 钩子必须放在项目根目录的 .git/hooks/pre-push，且需是可执行文件（chmod +x），名字不能带后缀（比如 pre-push.sh 不行）。Git 只认这个固定路径和名字，写错位置或权限不足时钩子完全静默失效——你 push 成功了，但它根本没跑。
- 别往
.githooks/或其他自定义目录放，Git 不会自动加载 - Windows 用户注意：用 Git Bash 运行，PowerShell 或 CMD 下的
pre-push很可能不触发 - 如果项目用
core.hooksPath指向了别的目录，得确认那个路径下也有pre-push
Go 测试命令怎么写进钩子里才可靠
直接写 go test -v ./... 有风险：它会遍历所有子模块，包括 vendor/ 或 internal/testdata 里故意写的失败用例，导致误拦。更稳的做法是只测主代码包，并显式排除测试辅助目录。
- 推荐命令：
go test -count=1 -short ./... | grep -v '/vendor/' | grep -v '/testdata/'（-count=1防缓存，-short跳过耗时测试） - 别依赖
GOOS/GOARCH环境变量默认值，钩子运行环境可能和本地开发不一致，建议显式设为GOOS=linux GOARCH=amd64 go test ...（除非你明确要多平台测试） - 如果项目含 cgo，确保钩子环境里装了对应 C 工具链，否则
go test直接报exec: "gcc": executable file not found
push 失败时怎么让错误信息真正显示出来
很多钩子脚本最后加了 exit 0 或没正确传递 go test 的退出码，结果测试失败但 push 仍成功。Git 要求钩子进程退出码非 0 才中止 push，且 stdout/stderr 必须直接输出到终端。
- 关键写法：
go test ./... || exit 1（不能写成if ! go test ...; then exit 1; fi冗余，但逻辑必须等价） - 避免重定向 stderr：像
go test 2>/dev/null会让失败时看不到具体哪个测试挂了 - 加个简单提示更友好：
echo "→ Running Go tests..."; go test -short ./... || { echo "✗ Tests failed — aborting push"; exit 1; }
团队协作时怎么避免钩子被绕过或不一致
pre-push 是本地钩子，不随 clone 自动分发，队友很可能没配、禁用（git push --no-verify）、或用了不同版本的 Go 导致测试行为差异。
- 在
README.md明确写清钩子路径、内容和安装命令，比如：cp scripts/pre-push .git/hooks/ && chmod +x .git/hooks/pre-push - CI 流程必须冗余校验：钩子只是第一道防线，
pre-push失败可以绕过，但 CI 中的go test不通过必须阻断合并 - Go 版本敏感？在钩子里加检查：
[[ $(go version | awk '{print $3}') == "go1.21.*" ]] || { echo "Requires Go 1.21+"; exit 1; }
最麻烦的其实是跨平台路径处理和 cgo 依赖——这两点一旦出问题，表现就是“别人能过我过不了”，排查时容易卡在环境差异上，而不是代码本身。
