本文详解 go get 命令的用法，涵盖语法规范、常见错误（如错误的 GitHub URL 格式）、模块模式与 GOPATH 模式的差异，并提供可运行示例及关键注意事项。
本文详解 `go get` 命令的用法，涵盖语法规范、常见错误（如错误的 github url 格式）、模块模式与 gopath 模式的差异，并提供可运行示例及关键注意事项。
go get 是 Go 语言内置的依赖获取与安装工具，用于下载指定导入路径的包及其依赖，并自动编译安装（生成二进制或归档文件）。但其行为在 GOPATH 模式 和 Go Modules 模式 下有显著差异，且对导入路径格式极为敏感——这是初学者最常见的出错点。
✅ 正确的导入路径格式
你原命令：
go get github.com:capotej/groupcache-db-experiment.git # ❌ 错误！
该写法混淆了 Git SSH/HTTPS URL 与 Go 的标准导入路径（import path）。Go 要求使用纯路径形式（不带协议、不带 .git 后缀），且必须以域名开头：
go get github.com/capotej/groupcache-db-experiment # ✅ 正确（基础包） go get github.com/capotej/groupcache-db-experiment/... # ✅ 安装该仓库下所有子包（推荐用于含多个命令/库的项目）
? 提示：/... 表示递归匹配当前路径下的所有 Go 包（包括子目录），确保命令行工具（如 cli, dbserver）和库均被构建安装。
? 常用标志（flags）说明
| 标志 | 作用 | 典型场景 |
|---|---|---|
| -v | 显示详细下载与构建过程 | 排查卡顿或失败原因 |
| -u | 强制更新已存在包及其依赖 | 升级到最新兼容版本 |
| -t | 同时获取测试依赖 | 运行 go test 前准备环境 |
| -d | 仅下载，不构建安装 | 仅需源码（如阅读或调试） |
例如，完整安装并更新该实验项目（含 verbose 输出）：
go get -v -u github.com/capotej/groupcache-db-experiment/...
输出将清晰展示依赖树下载顺序（如 github.com/golang/groupcache）及各子包构建路径。
⚠️ 重要注意事项
-
模块模式优先：Go 1.16+ 默认启用模块（GO111MODULE=on）。此时 go get 主要操作 go.mod 文件，安装的包会记录为依赖项，不再写入 $GOPATH/src，而是缓存在 $GOPATH/pkg/mod。若需传统 GOPATH 行为，请临时禁用模块：
GO111MODULE=off go get github.com/capotej/groupcache-db-experiment/...
避免 insecure 模式：-insecure 允许 HTTP 协议拉取代码，存在安全风险，生产环境严禁使用。
子模块与 vendor：go get 会自动初始化并更新 Git 子模块，但完全忽略 vendor/ 目录——模块模式下应通过 go mod vendor 显式生成。
-
版本控制：在模块模式中，建议显式指定版本以保证可重现性：
go get github.com/capotej/groupcache-db-experiment@v0.1.0
✅ 总结
go get 的核心是“用标准导入路径代替 Git URL”。牢记：
? 路径 = github.com/用户名/仓库名[/子路径]，无协议、无 .git；
? 本地开发推荐启用 Go Modules（默认），用 go get 管理依赖并自动维护 go.mod；
? 遇到问题先加 -v 查看详细日志，再检查 Go 版本与模块状态（go env GO111MODULE）。
掌握这些原则，即可高效、安全地集成任何公开 Go 包。
