先确认goimports是否在PATH中，90%的pre-commit钩子失效源于命令找不到；必须安装goimports并导出$GOPATH/bin到PATH，钩子脚本应使用goimports -w而非gofmt，且CI需复现相同命令（含-local参数）确保规则一致。
Git pre-commit 钩子不生效？先确认 goimports 是否在 PATH 中
本地钩子脚本执行失败，90% 是因为 goimports 命令找不到。GoLand 自身的格式化配置（如 File Watchers）和 Git 钩子是两套独立机制，后者完全依赖系统 shell 环境。
在终端运行：which goimports。如果返回空，说明没安装或不在 $PATH 里。必须补上：
go install golang.org/x/tools/cmd/goimports@latest- 若用 zsh/bash，检查
~/.zshrc或~/.bash_profile是否导出了$GOPATH/bin（例如export PATH=$PATH:$GOPATH/bin） - 重启终端或执行
source ~/.zshrc再验证
pre-commit 脚本里别只用 gofmt，goimports 才管 import 整理
很多团队写钩子时只调 gofmt -w，结果提交后仍出现未使用包、import 顺序混乱——因为 gofmt 不处理导入语句。
正确做法是用 goimports -w 替代，并加 -local 参数区分内部包（可选）：
#!/bin/bash
# .git/hooks/pre-commit
git diff --cached --name-only --diff-filter=ACM | grep '\.go$' | while read file; do
if ! goimports -w -local "github.com/yourorg" "$file" 2>/dev/null; then
echo "❌ goimports failed on $file"
exit 1
fi
done-
-local后跟你的模块前缀（如github.com/myco），goimports会把匹配的包单独分组 - 务必用
git diff --cached，只检查暂存区文件，避免误格式化未 add 的文件 - 不要用
go fmt—— 它是旧命令，已弃用，等价于gofmt
GoLand 提交界面勾选 “Go fmt” ≠ 运行 pre-commit 钩子
GoLand 的 Git 提交弹窗里勾选 Go fmt，只是 IDE 在点击「Commit」瞬间调用一次 gofmt（或 goimports，取决于 Go Tools 设置），它不触发你写的 .git/hooks/pre-commit。
这意味着：
- IDE 提交时格式化 ≠ 钩子生效：别人用命令行
git commit就绕过你的钩子 - IDE 提交时只跑一次，不校验是否真有修改；而钩子脚本里应加
git add $file把格式化结果重新暂存，否则提交的仍是旧内容 - 如果项目用了
.editorconfig，钩子脚本不读它——goimports始终按默认规则（tab width=8，use tabs=false）格式化，与 IDE 显示可能不一致
CI 流水线必须复现同一套格式化逻辑
本地钩子再完善，CI 没同步就会出现“本地能过，CI 报格式错误”。关键点就一个：CI 脚本里必须用和钩子完全相同的命令。
例如 GitHub Actions 中要这样写：
- name: Check goimports
run: |
git ls-files "*.go" | xargs goimports -l -local "github.com/yourorg"
# 注意：-l 表示只输出不一致的文件名，非零退出码即失败- CI 里禁用
-w，只用-l检查，避免自动改写文件导致 diff 混乱 - 确保 CI 环境也装了同版本
goimports（@latest可能随时间漂移，建议锁 commit hash） - 别信 “CI 用 gofmt 就够了”——只要本地钩子用了
goimports，CI 就必须用它，否则规则不一致
最易被忽略的是 goimports -local 参数值：它必须和团队约定的模块路径完全一致，少一个字符，分组就错位。
