本文介绍如何通过 Bash 预提交钩子（pre-commit hook）自动执行 go build 并准确捕获其返回码，确保仅当代码可成功构建时才允许提交，从而防止不可编译代码进入版本库。

本文介绍如何通过 bash 预提交钩子（pre-commit hook）自动执行 `go build` 并准确捕获其返回码，确保仅当代码可成功构建时才允许提交，从而防止不可编译代码进入版本库。

在 Go 项目开发中，保障代码的可构建性是 CI/CD 流水线的第一道防线。将构建检查前置到本地提交阶段，能显著提升协作效率与代码质量。Git 的 pre-commit 钩子正是实现这一目标的理想入口——它在 git commit 执行前运行，若脚本以非零状态码退出，Git 将中止本次提交。

关键在于：go build 本身已遵循 POSIX 规范——构建成功时返回 0，失败时返回非零值（如 2）。因此，无需额外解析输出或手动判断字符串，只需让 Shell 正确传播该退出码即可。

最简洁可靠的做法是使用 set -e（即“error exit”模式），它会令脚本在任意命令失败时立即终止并返回该命令的退出码：

batch-git-url-replace

批量替换指定目录下所有 Git 仓库的远程地址（remote URL）。 当用户需要将 Git 仓库从一个服务器迁移到另一个服务器时使用。 触发词：git remote 替换、git url 批量修改、git 仓库迁移、更换 git 地址、批量修改 remote url。

下载

#!/bin/bash
set -e

# 构建当前模块（需在 go.mod 所在目录执行）
go build -o ./tmp/_build_test .

# 可选：串联更多静态检查，任一失败即阻断提交
go vet ./...
golint ./...  # 需提前安装：go install golang.org/x/lint/golint@latest

✅ 注意事项：

• 将上述脚本保存为 .git/hooks/pre-commit，并赋予可执行权限：
  chmod +x .git/hooks/pre-commit
• 确保脚本以 #!/bin/bash 开头（而非 #!/usr/bin/env bash），因 Git 在 Windows 上通过 MSYS2/MinGW 调用 bash，路径兼容性更稳定；
• go build 默认构建当前目录的 main 包；若项目含多个可执行文件，建议显式指定目标，例如 go build -o bin/app ./cmd/app；
• 如需跳过钩子调试（例如临时提交构建失败的中间版本），可用 git commit --no-verify 强制绕过；
• 推荐将钩子逻辑封装为独立脚本（如 scripts/precommit.sh）并通过 pre-commit 框架（如 pre-commit.com）统一管理，便于团队共享与版本控制。

总结：利用 set -e + 原生命令链式调用，既符合 Shell 最佳实践，又完全复用 go build 内置的退出码语义，无需冗余判断，安全、轻量、可扩展。