go mod init 仅初始化 go.mod 文件，不下载依赖，故 go build 会因缺少包报错；需运行 go mod tidy 或确保 go111module=on 后用 go build 触发自动下载。
Go mod init 之后为什么 go build 报错找不到包
执行 go mod init 只是初始化了 go.mod 文件，并不会自动下载依赖。如果项目里用了第三方包（比如 github.com/gin-gonic/gin），但本地没缓存，go build 就会报 cannot find package。
解决办法是让 Go 自动补全并下载缺失的依赖：
- 运行
go mod tidy：清理未引用的依赖，同时拉取当前代码中 import 的所有包及其间接依赖 - 或者先写好
main.go，再执行go build—— Go 1.16+ 默认会自动触发go mod download（前提是GO111MODULE=on） - 检查
GO111MODULE环境变量是否为on或auto；在 GOPATH 外新建项目时，auto模式才生效
如何替换私有仓库或未发布模块的依赖
当你想用自己 fork 的版本、本地调试版，或公司内网 Git 仓库替代原模块时，不能只改 go.mod 里的路径——Go 不会自动识别，必须显式 replace。
例如，要把官方 golang.org/x/net 替换成本地修改版：
立即学习“go语言免费学习笔记（深入）”；
replace golang.org/x/net => ./x/net
或者指向另一个 Git 地址：
replace github.com/sirupsen/logrus => github.com/myfork/logrus v1.9.0
注意点：
-
replace只在当前 module 生效，子模块不会继承 - 如果目标路径是本地目录，必须包含
go.mod，且版本号写成=> ./path（不带版本） - 使用
go mod edit -replace命令修改更安全，避免手误破坏格式
go.sum 文件变动频繁，能删掉吗
不能删。go.sum 是模块校验和快照，记录每个依赖的 zip 哈希值，用于防止依赖被篡改或意外变更。CI/CD 中若缺失或内容不匹配，go build 或 go test 会直接失败。
常见困惑：
- 每次
go mod tidy都改go.sum？→ 是因为引入了新间接依赖，或上游模块发布了新版（即使你没动go.mod） - 多人协作时
go.sum冲突？→ 应以合并后的内容为准，Go 工具链会验证全部条目，不是“谁提交谁赢” - 想跳过校验？→ 不推荐。临时可用
GOINSECURE=your-domain.com绕过私有源 HTTPS 校验，但不等于跳过go.sum
vendor 目录还有必要保留吗
绝大多数场景下不需要。Go 1.14+ 的 module 模式已足够稳定，vendor 主要用于两类情况：
- 离线构建环境（无网络，无法
go mod download） - 对构建可重现性要求极高，且不信任代理缓存（如某些金融/航天场景）
如果决定启用 vendor：
- 用
go mod vendor生成（不是复制粘贴） - 后续依赖变更后，需重新运行该命令，否则 vendor 不会自动同步
-
go build -mod=vendor才真正从 vendor 构建；不加参数仍走 $GOPATH/pkg/mod
一个容易被忽略的事实：vendor 不会锁定间接依赖的版本——它只保存 go.mod 显式声明的依赖树，而 go.sum 才完整记录所有哈希。
