go mod init 必须带明确域名前缀，否则模块路径不可寻址；go111module=on 和 goproxy 需固化配置；pre-commit 应包含 go vet 和 staticcheck；tools.go 锁定工具版本；go.mod 首行需声明 go 版本。
go mod init 必须带明确域名前缀
不写域名前缀的 go mod init myproject 会导致模块路径不可寻址、依赖无法被正确解析，尤其在私有仓库或跨团队引用时直接失败。Go 模块路径本质是导入路径，必须能唯一标识并可被 go get 定位。
实操建议：
Golang Google Wire
下载
在 Go 中使用 google/wire 实现编译时依赖注入——wire.NewSet、wire.Build、wire.Bind（接口→实现）、wire.Struct、wire.Value、wire.Interface
- 统一使用公司/组织域名反向格式，如
go mod init github.com/your-org/backend或go mod init git.internal.company.com/platform/auth - 若用 GitLab 或自建 Gitee，确保 URL 与实际 clone 地址一致（含端口、子组路径），否则
go list -m会报no matching versions - 禁止用本地路径（
file://）或相对路径初始化，CI 中会因 GOPATH fallback 导致模块识别失败
GO111MODULE=on 和 GOPROXY 必须固化进项目配置
仅靠开发者手动 go env -w 设置极易遗漏或冲突，尤其新人入职或切换分支后环境漂移。模块行为一旦回退到 GOPATH 模式，go build 会忽略 go.mod，vendor 目录失效，依赖版本失控。
实操建议：
- 在项目根目录放
.env文件（配合 direnv）或 CI 脚本中显式导出：export GO111MODULE=on、export GOPROXY="https://goproxy.cn,direct" - 私有模块必须同步设置
GOPRIVATE=git.internal.company.com/*，漏设会导致go mod download报错unknown revision，且错误信息不提示原因 - 验证是否生效：运行
go env GO111MODULE GOPROXY GOPRIVATE，三者输出均不应为空或auto
pre-commit 必须跑 go vet + staticcheck，而非仅 gofmt
格式化解决不了空指针、资源泄漏、未处理错误等运行时风险。只配 gofmt 或 goimports 的 pre-commit，等于把静态检查交给 PR Review 人工 eyeball，既慢又不可靠。
实操建议：
- 用
staticcheck替代已归档的golint：go install honnef.co/go/tools/cmd/staticcheck@latest - pre-commit hook 写成：
go vet ./ && staticcheck -checks=all ./，失败直接阻断提交 - CI 中额外加
go test -race ./，尤其当代码含sync.Map、全局变量或 channel 复用时，竞态问题不会在单测里暴露 - 避免在 IDE 里启用 “auto-fix on save”，不同人插件版本不一，容易导致 diff 巨大或修复不一致
tools.go 是工具版本锁定的唯一可靠方式
靠文档写 “请安装 golangci-lint v1.54.2” 没用——有人装错版本、有人 PATH 混乱、有人用 brew 装而别人用 asdf，make lint 就会静默降级或失败。
实操建议：
- 新建
tools.go文件，内容仅两行：//go:build tools<br>package tools<br><br>import _ "github.com/golangci/golangci-lint/cmd/golangci-lint"
- 执行
go mod tidy后，该工具版本即被锁进go.sum，go install时自动匹配 - Makefile 中调用时写
$(GOBIN)/golangci-lint run，不依赖 PATH，也不怕多版本共存 - 注意：
tools.go必须放在模块根目录，且模块已初始化（有go.mod），否则go mod tidy不识别
go.mod，且首行声明 go 1.21（或团队约定版本）。没这行，go list -m 可能返回空，go mod vendor 行为不可控，连 pre-commit 都可能跳过模块检查。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
