Go 1.11 起原生支持 go mod 依赖管理，无需 dep 等工具；执行 go mod init example.com/myproject 初始化模块并生成 go.mod，路径需合法且避免 GOPATH 冲突；go get 支持 @tag、@branch、@commit 精确拉取；replace 可映射私有/本地依赖但需匹配版本；go mod tidy 自动清理未用依赖并补全 indirect 项。
Go 1.11 引入 go mod 后，Golang 原生依赖管理已稳定可用；无需额外工具（如 dep、glide），直接用 go mod 命令即可完成初始化、下载、升级、替换等全部操作。
如何初始化一个模块并生成 go.mod
在项目根目录执行：
go mod init example.com/myproject其中
example.com/myproject 是模块路径（module path），应尽量与未来代码发布地址一致（如 GitHub 地址）。若当前目录已有 import 语句，go mod init 会自动扫描并写入依赖；但不会自动下载——需后续运行 go build 或 go mod download 才真正拉取。
常见错误：
• 目录下已有 Gopkg.lock 或 vendor/，可能干扰初始化判断
• 模块路径含空格或非法字符，导致 go mod 解析失败
• 在 $GOPATH/src 下初始化旧式项目，可能触发 GOPATH mode（可通过 GO111MODULE=on go mod init 强制启用模块模式）
如何精确控制依赖版本（包括 commit、tag、branch）
go get 默认拉取 latest tagged version（如 v1.2.3），若需指定更细粒度的版本，可直接传入 commit hash、分支名或伪版本号：
立即学习“go语言免费学习笔记（深入）”；
-
go get github.com/sirupsen/logrus@v1.9.3→ 拉取明确 tag -
go get github.com/sirupsen/logrus@master→ 拉取 master 分支最新 commit（会转为伪版本，如v1.9.3-0.20230512142301-abc123...） -
go get github.com/sirupsen/logrus@abc123→ 拉取特定 commit（同样转为伪版本）
注意：go get 修改的是 go.mod 中的 require 行，并自动更新 go.sum。若只想更新 go.sum 而不改依赖版本，用 go mod verify 或 go mod download -json 更安全。
如何替换私有仓库或本地调试依赖
使用 replace 指令可将远程模块映射到本地路径或不同 URL：
replace github.com/org/legacy => ./local/legacy replace golang.org/x/net => github.com/golang/net v0.14.0
replace 只在当前模块构建时生效，不影响下游模块；它不修改 go.sum 校验逻辑（仍校验原始模块的 checksum），但会跳过下载原始路径——所以本地路径必须包含合法的 go.mod 文件，且版本号要匹配 require 中声明的版本（否则 go build 报错 missing go.mod 或 version mismatch）。
常见陷阱：
• replace 后忘记运行 go mod tidy，导致 go.mod 未同步更新
• 本地路径含中文或符号，Windows 下易因路径分隔符引发读取失败
• 替换后未清理 vendor/（如有），可能造成构建时混用旧文件
如何安全清理未使用的依赖并锁定所有间接依赖
go mod tidy 是最常用也最易被低估的命令：它会自动删除 go.mod 中未被当前代码 import 的模块，并添加缺失的间接依赖（indirect 标记项）到 require 列表中。
关键点：
• 必须在 clean working directory 下运行（避免误删还在开发中的 import）
• 若项目含多个 main 包（如 cmd/ 下多个子命令），需确保每个入口都已 go build 过，否则 tidy 可能漏掉某些依赖
• go.sum 会在 tidy 时自动更新，但不会自动删除旧 checksum 条目——长期积累可能导致该文件膨胀，此时可手动清理（保留每行末尾带 // indirect 的 checksum 即可）
生产环境建议每次提交前跑一遍 go mod tidy && git diff --quiet go.mod go.sum || git add go.mod go.sum，避免依赖漂移。
