Go多人协作必须统一GOPROXY、GOPRIVATE、gopls workspace配置及CI测试策略，通过go.work、.vscode/settings.json、Makefile和pre-commit hook固化规则，禁用全局设置并强制-race与覆盖率检查。
Go Modules 本地缓存与私有仓库代理必须统一配置
多人协作时，go.mod 中依赖版本不一致、拉取私有包超时或 403，根本原因常是 GOPROXY 配置不统一。团队不能依赖个人 go env -w 设置，必须在项目根目录下通过 go.work 或构建脚本固化代理策略。
- 所有成员执行
go env -w GOPROXY="https://goproxy.cn,direct"（国内推荐），避免部分人用默认proxy.golang.org导致私有模块失败 - 若使用私有 Git 仓库（如 Gitea/GitLab），需额外配置
GOPRIVATE=git.example.com/*，否则 Go 会强制走代理校验 checksum - CI/CD 流水线中禁止写死
GO111MODULE=on—— Go 1.21+ 默认启用，硬设反而可能干扰 vendor 模式
vscode-go 插件 + gopls 的 workspace 配置要隔离 per-project
团队里有人用 gopls 的 build.experimentalWorkspaceModule，有人没开，会导致代码补全错乱、跳转到错误 vendor 路径。这不是插件版本问题，而是 workspace 设置未纳入版本控制。
- 在项目根目录添加
.vscode/settings.json，显式声明：{ "go.useLanguageServer": true, "gopls.env": { "GOPROXY": "https://goproxy.cn,direct", "GOPRIVATE": "git.example.com/*" }, "gopls.settings": { "build.directoryFilters": ["-node_modules", "-vendor"], "analyses": {"STRICT": true} } } - 禁用全局
gopls配置：删除$HOME/Library/Application Support/Code/User/globalStorage/golang.go/（macOS）或对应路径下的缓存，避免旧设置残留 - VS Code 打开文件夹时，确认右下角显示 “Go (workspace)” 而非 “Go (global)”
Makefile + go run -mod=readonly 防止意外修改 go.sum
开发中执行 go get 或 go mod tidy 后提交了变更的 go.sum，CI 构建却报 checksum mismatch —— 很可能是某人本地 GOPROXY 不一致，或用了不同 Go 版本生成了新哈希。
- 所有构建命令统一走
Makefile，例如：build: go run -mod=readonly main.go tidy: go mod tidy -v && git diff --quiet go.sum || (echo "go.sum changed; commit it"; exit 1)
-
-mod=readonly强制拒绝任何隐式模块修改，运行时报错比上线后崩溃更早暴露问题 - Git 提交前加 pre-commit hook 检查：
go list -m all | grep -q 'dirty' && exit 1 || true（防未提交的本地修改影响依赖解析）
go test -race 和覆盖率报告必须在 CI 中强制开启
本地跑 go test 通过就合入 PR，结果线上偶发 panic：data race 或空指针。因为开发者默认不加 -race，也从不看覆盖率缺口。
立即学习“go语言免费学习笔记（深入）”；
- CI 脚本中固定写死：
go test -race -coverprofile=coverage.out -covermode=atomic ./...
- 用
go tool cover -func=coverage.out输出函数级覆盖，重点检查 handler、middleware、db transaction 等关键路径是否低于 80% - 禁止在
test命令中使用-short—— 团队集成测试不是“可选”，而是准入门槛
