答案：go依赖下载失败主因是go111module未启用、goproxy未配置国内镜像或gomodcache路径异常，需依次执行go env -w go111module=on、go env -w goproxy=https://goproxy.cn,direct并确认gobin在path中。
Go环境装好了，go version 能跑，但 go get 一执行就卡住、超时或报 cannot find module providing package —— 这不是环境没装好，而是依赖获取链路上某个环节断了。核心问题从来不是“会不会装”，而是“包从哪来、怎么走通、哪里会掉坑”。
go mod init 后 go get 仍失败：GO111MODULE 没真开
即使 go version 显示 1.16+，go get 仍走老式 GOPATH 模式，说明模块系统实际被禁用。
- 运行
go env GO111MODULE，如果输出off，必须手动开启：go env -w GO111MODULE=on - 某些旧终端（尤其 Windows CMD）不自动加载新环境变量，要关掉重开；macOS/Linux 用户改完
~/.zshrc后记得source ~/.zshrc - 临时验证：在项目目录下执行
go mod init example.com/test，成功生成go.mod文件才算真正启用
go get 报错 “timeout” 或 “no matching versions”：GOPROXY 配置失效
默认 GOPROXY 是 https://proxy.golang.org，国内直连基本不可用，且 direct 回退机制不会自动触发——它只在代理明确返回 404 时才试本地，而超时≠404。
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
- 设国内可用代理：
go env -w GOPROXY=https://goproxy.cn,direct（注意逗号后不能有空格） - 验证是否生效：
go env GOPROXY输出应与上一步一致；再执行go get -d golang.org/x/net，看是否快速拉取到go.mod中 - 若仍失败，检查公司网络是否拦截了
.cn域名，可换https://mirrors.aliyun.com/goproxy/或https://goproxy.io
go install 工具类包（如 protoc-gen-go）不进 PATH
很多工具（protoc-gen-go、gofmt、goimports）需通过 go install 安装到 $GOBIN，但默认 $GOBIN 不在系统 PATH 中，导致命令行找不到。
- 先确认
GOBIN路径：go env GOBIN，通常为$GOPATH/bin（如/home/user/go/bin） - 把该路径加进系统
PATH：Linux/macOS 编辑~/.bashrc或~/.zshrc，追加export PATH=$PATH:/home/user/go/bin；Windows 在系统环境变量中添加 - 安装工具时必须带版本后缀（Go 1.21+ 强制要求）：
go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
手动下载的包不被识别：mod cache 路径和 vendor 冲突
有人把 GitHub 上 clone 的代码直接扔进 $GOPATH/src，发现 go build 还是报错——因为启用了 go mod 后，Go 默认只认 $GOMODCACHE（通常是 $GOPATH/pkg/mod）里的包，src 目录被完全忽略。
- 不要往
$GOPATH/src放东西；想离线安装，应解压到$GOMODCACHE/域名/包名@版本对应子目录，并确保go.sum文件存在校验值 - 若项目强制用
vendor，需先go mod vendor生成vendor/目录，再加-mod=vendor参数编译：go build -mod=vendor - 最稳的离线方式：在能联网机器上
go mod download全量缓存，然后把整个$GOMODCACHE目录拷过去
真正卡住人的往往不是命令本身，而是环境变量之间的隐式依赖：GO111MODULE 控制模式开关，GOPROXY 决定源地址，GOBIN 影响工具可达性，GOMODCACHE 则是模块落地的唯一合法位置。四个变量串起来，才是依赖能装上的最小闭环。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
