pre-commit钩子不触发需检查文件权限和shebang；go检查应打包为静态二进制而非go run；规范检查推荐gofmt+go vet+revive；跨平台需用filepath.join和posix shell。
pre-commit 钩子不触发？检查 .git/hooks/pre-commit 文件权限和 shebang
Git Hook 脚本必须是可执行文件，且第一行 #!/bin/bash（或 #!/usr/bin/env bash）不能少。常见错误是直接写了个 Go 程序但没加执行权限，或者用 go run 写在脚本里却忘了处理 os.Args[0] 路径问题。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 确保
.git/hooks/pre-commit是普通文件（不是软链接），且有执行权限：chmod +x .git/hooks/pre-commit - 脚本开头必须是有效的 shebang；若用 Go 编译后的二进制，推荐直接调用：
./scripts/precommit-check，而非go run ./cmd/precommit/main.go - 避免在钩子里依赖当前工作目录下的
go命令——CI 和本地环境的GOPATH/GOROOT可能不一致
用 go run 执行检查逻辑？别在 pre-commit 里实时编译
go run 每次都触发编译，哪怕只改一行代码，也会让提交卡顿 1–3 秒，尤其项目模块多时更明显。这不是“慢一点”，而是会实质性破坏开发节奏。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 把检查逻辑打包成静态二进制：
GOOS=linux GOARCH=amd64 go build -o ./bin/precommit-check ./cmd/precommit（Windows/macOS 同理） - 钩子中只调用已构建好的二进制：
if ! ./bin/precommit-check; then exit 1; fi - 如果真要用
go run调试，务必加-a参数强制重编译，并确认go env GOCACHE不为空——否则缓存失效反而更慢
Go 代码规范检查该用哪些工具？gofmt/gofmt + revive 组合最稳
仅靠 gofmt -l -w 只能修格式，漏掉未导出函数命名、error 忘记检查、context 传递缺失等真实问题。但全上 staticcheck 又太重，CI 上容易误报。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 基础必选：
gofmt -l（只检测，不自动改）、go vet（标准检查）、revive（替代 golint，可配.revive.toml控制规则） - 慎用：
staticcheck放 CI，不放 pre-commit——它扫描整个 module，耗时高且部分规则（如 SA1019）对内部 API 过于激进 - 路径控制很重要：所有工具默认检查全部
*.go，pre-commit 应只查 git stage 中的文件，用git diff --cached --name-only -- '*.go'获取列表再传给工具
如何让 Git Hook 兼容 Windows / macOS / Linux？别硬编码路径分隔符
Go 程序里写死 "./scripts/check.sh" 或拼接 "C:\tools\check.exe"，会导致跨平台失效。Git 在 Windows 上用 msys2 环境运行钩子，路径语义和原生 cmd 不同。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- Go 工具自身用
filepath.Join构造路径，输出二进制时用runtime.GOOS区分行为（比如 Windows 下跳过某些 shell 特性） - 钩子脚本统一用 POSIX shell（
#!/bin/sh），避免cmd.exe语法；Windows 用户需确认 Git 安装时勾选了 “Use Windows’ default console window” - 测试时别只跑
git commit，要模拟真实场景：git add main.go && git commit -m "test"，否则 stage 空时很多检查会跳过
真正麻烦的不是写钩子，而是让不同人 clone 下来就能跑通——工具链版本、shell 类型、Go 模块初始化状态，任何一个没对齐都会静默失败。建议把 make setup-hooks 命令写进 README，并验证 git config core.hooksPath 是否被全局配置覆盖。
