大厂go开发规范由ci流程、安全扫描等倒逼形成硬约束，go.mod与go.sum须成对提交且仅用go get修改版本；goprivate需精确配置；replace仅限本地调试；internal目录是编译器强制访问控制。
大厂的 Go 开发规范不是靠拍脑袋定出来的，而是由 CI 流程、安全扫描、协作成本和线上稳定性倒逼形成的硬约束。直接照搬“最佳实践”文档会踩坑，真正起作用的是那些被自动化工具卡死的红线。
go.mod 和 go.sum 必须成对提交，且只能用 go get 驱动
手动改 go.mod 里的版本号（比如把 v1.5.2 改成 v1.5.3）是高频错误。CI 会校验 go.sum 是否包含该版本的 checksum，不一致就拒收 PR。
- 升级依赖：运行
go get github.com/foo/bar@v1.5.3，再执行go mod tidy - 降级或修复漏洞：同样走
go get，不要删go.sum行或清空它 - CI 中发现
go.sum缺失条目，说明本地没跑go mod tidy，不是“重生成”就能过，必须补全依赖树
GOPRIVATE 必须精确配置，否则私有模块拉不到还可能泄密
企业内模块路径如 git.internal.company.com/auth，如果只设 GOPRIVATE=company.com，会导致 github.com/company/private 也被当成私有模块——结果就是公开包也拉不下来。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 正确写法：
go env -w GOPRIVATE=git.internal.company.com - 多个域名用逗号分隔：
go env -w GOPRIVATE=git.internal.company.com,git.corp.other.org -
*不合法，不支持通配符 - Dockerfile 或 CI 脚本里要预设该变量，不能只靠开发者本地配置
replace 只允许本地调试，严禁进主干分支
代码扫描工具（比如 golangci-lint + 自定义规则）会把 replace 行标为高危项，并要求在 PR 描述里写明原因和移除时间点。
- 本地临时替换：用
go mod edit -replace old=local/path - PR 提交前必须删掉
replace行，或用go mod edit -dropreplace - SSH 克隆失败时，
replace不是解法——应配~/.gitconfig的insteadOf规则
internal 目录不是命名习惯，而是编译期访问控制契约
放在 /internal/ 下的包，连同其子目录，**任何外部模块都无法 import**。这不是约定，是 Go 编译器强制规则。
- 误放
pkg/internal/util→ 外部模块能 importpkg/internal/util？不能 - 误放
pkg/util/internal→ 外部模块能 importpkg/util/internal？能（因为不在顶层/internal/下） - 想限制访问，必须确保路径形如
your-module/internal/xxx，且xxx是模块根目录下的internal子目录
最易被忽略的是：所有这些规范，都不是靠人盯，而是由 pre-commit hook、CI job、golangci-lint 规则、以及代码扫描平台实时拦截。写错一次 go.mod，可能卡住整个团队的发布流水线。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
