go get安装失败主因是模块路径错误或未启用模块模式；需确保有go.mod、用完整路径、配置goproxy和goprivate，依赖问题优先运行go mod tidy。
go get 安装失败：找不到模块或 404 错误
多数报错其实是模块路径写错了，或者 Go 没启用模块模式。go get 默认行为在 Go 1.16+ 已变：它只在 module-aware 模式下工作，且不再自动写入 GO111MODULE=on。
- 确认当前目录有
go.mod文件；没有就先运行go mod init example.com/myapp - 安装时用完整模块路径，比如
go get github.com/gin-gonic/gin@v1.9.1，不是go get gin-gonic/gin - 如果遇到
unknown revision或module not found，检查 GitHub 仓库是否公开、路径大小写是否匹配（Gin≠gin） - 公司内网或私有仓库需提前配置
GOPRIVATE=*.your-company.com，否则 Go 会强行走 proxy
go get -u 升级依赖为什么没更新子依赖？
go get -u 默认只升级直接依赖（即 go.mod 中显式列出的模块），不会递归升级间接依赖（require 下带 // indirect 标记的那些）。
- 要强制更新整个依赖树，改用
go get -u ./...（注意末尾的./...） - 更可控的方式是先
go list -u -m all查哪些可升级，再针对性go get path@version -
go get -u可能降级某些间接依赖——因为新版本主依赖可能要求更老的子模块，这是 Go 模块 resolver 的正常行为
go get 后 go build 报 missing package，但 go.mod 里明明有
常见于本地开发时手动修改了 go.mod 但没同步 vendor 或没触发依赖下载，也可能 replace 规则写错。
- 运行
go mod tidy—— 它会删掉未使用的依赖、补全缺失的间接依赖，并校验所有import是否可达 - 检查是否有
replace指向了不存在的本地路径，比如replace github.com/some/lib => ../some-lib，而../some-lib目录根本不存在 - 如果用了
go.work，确认当前目录在 work file 覆盖范围内，否则go get可能作用于错误的 module
国内环境 go get 太慢或超时
Go 默认从 proxy.golang.org 拉包，国内直连不稳定。不能只靠 export GOPROXY=https://goproxy.cn 就完事，得配合 fallback 和私有源策略。
- 推荐设置：
export GOPROXY=https://goproxy.cn,direct（逗号分隔，direct表示对GOPRIVATE域名跳过 proxy） - 避免只设
GOPROXY=https://goproxy.cn，否则私有模块会因 404 卡住；必须加,direct - 若公司有 Nexus/Artifactory，可配
GOPROXY=https://nexus.example.com/repository/goproxy/,https://goproxy.cn,direct -
go env -w比临时 export 更可靠，比如go env -w GOPROXY="https://goproxy.cn,direct"
go.sum 冲突、多版本共存这些点，实际调试时往往卡在最前面两步——路径对不对、模块启没启用。别急着查文档，先 go mod graph | grep xxx 看依赖是不是真被引入了。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
