95%的“缺少依赖包”问题根源在于代理、模块模式和路径未对齐；需确保go111module=on、goproxy正确配置（含direct）、且在项目根目录执行go mod init和go mod tidy。
直接说结论：95% 的“缺少依赖包”不是真缺，而是 go 拉不到——根源在代理、模块模式和路径三者没对齐，不是手动补包或换源就能一劳永逸解决的。
GO111MODULE=off 导致 go get 完全不走模块逻辑
这是新手最常踩的坑：明明装了 Go 1.11+，go get 却还往 $GOPATH/src 写，且对 golang.org/x/... 类包静默失败。
- 运行
go env GO111MODULE，如果输出off，说明模块功能被禁用 - 临时启用：
go env -w GO111MODULE=on（推荐）或在当前终端执行export GO111MODULE=on - 不要依赖
auto模式——它只在项目不在$GOPATH时才生效，而很多旧项目或 IDE 启动终端仍默认进$GOPATH - 验证是否生效：新建空目录，
go mod init tmp成功即表示模块已激活
GOPROXY 设置无效或未生效
go: failed to download golang.org/x/net 这类错误，本质是 go 尝试直连被阻断，但你设置了 GOPROXY 却没起作用。
Go语言（Golang）1.26.0
下载
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
- 确认设置方式正确：
go env -w GOPROXY=https://goproxy.cn,direct（逗号后必须写direct，否则私有模块会失败） - 检查是否被覆盖：运行
go env GOPROXY，输出应为完整 URL，而非https://proxy.golang.org或空值 - Windows 用户注意 PowerShell 和 CMD 环境变量隔离，建议统一用
go env -w设置，避免 shell 配置文件冲突 - 若公司内网需跳过代理，加
go env -w GOPRIVATE=git.company.com,github.com/myteam（多个域名用逗号分隔，不带协议）
go mod tidy 报 missing go.sum entry 或 checksum mismatch
这不是网络问题，是本地校验机制在拦截——go.sum 缺失或哈希不匹配，go build 就拒绝加载，哪怕包已下载到 $GOPATH/pkg/mod。
- 先运行
go mod download补全所有模块的校验和，再go mod tidy - 若仍报错，检查
go.mod中某行末尾是否有异常空格或不可见字符（尤其从网页复制时） - CI 构建失败常见原因是缓存了旧
go.sum，但go.mod已更新——必须同步提交两者，不能只提go.mod - 不要手动编辑
go.sum：它由工具链自动生成，手改会导致后续所有命令拒绝执行
依赖实际存在却提示 package not found
编辑器报红、go build 找不到包，但 go list -m all 能列出该模块——说明 Go 工具链认得，只是当前上下文没加载进来。
- VS Code 用户：检查状态栏右下角 Go 版本是否与终端一致，点击切换；或按
Cmd/Ctrl+Shift+P→ “Go: Restart Language Server” - 确保项目根目录有
go.mod文件，且当前终端工作目录就是该目录（go不会向上递归找go.mod） - GoLand 用户：File → Project Structure → Project SDK 必须指向正确的 Go SDK 路径，不是系统 PATH 里的任意版本
- 执行
go clean -modcache清理模块缓存后再go mod tidy，避免旧缓存干扰解析
真正麻烦的不是拉不到包，而是拉到了错误版本的包——比如某个间接依赖悄悄升级后改变了接口行为，但 go list -m all 里只显示 // indirect，没人去翻它的 changelog。这时候靠重设代理或重装 Go 都没用，得用 go mod graph 定位源头，再决定是 replace 还是推动上游修复。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
