17370845950

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 dif
  f --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，也从不看覆盖率缺口。

• CI 脚本中固定写死：

  go test -race -coverprofile=coverage.out -covermode=atomic ./...

• 用 go tool cover -func=coverage.out 输出函数级覆盖，重点检查 handler、middleware、db transaction 等关键路径是否低于 80%
• 禁止在 test 命令中使用 -short —— 团队集成测试不是“可选”，而是准入门槛

Go 多人环境最难控的从来不是工具链安装，而是每个环节对「一致性」的让步：代理地址、lsp 配置、模块只读策略、竞态检测开关——它们散落在 shell 环境、编辑器设置、Makefile、CI 脚本里，漏掉任意一处，就会在某个深夜把错误推给所有人。