根本原因是go111module未启用或go.mod缺失导致退化为gopath模式，此时goproxy失效；必须确保go env go111module=on且项目根目录存在go.mod文件，否则代理配置不生效。
为什么 go mod download 总是去 proxy.golang.org 而不是你配置的私有代理？
根本原因不是命令写错了，而是 GO111MODULE 未启用或 go.mod 文件缺失导致 Go 退化为 GOPATH 模式——此时所有模块行为（包括代理选择）完全失效。只有在 module 模式下，GOPROXY 环境变量才生效。
实操确认方式：
- 运行 go env GO111MODULE，输出必须是 on；
- 当前目录下必须存在 go.mod（哪怕只有一行 module example.com/foo）；
- 若项目在 $GOPATH/src 下且无 go.mod，Go 会无视所有 module 相关配置。
- 临时开启：执行
go env -w GO111MODULE=on - 初始化模块：在项目根目录运行
go mod init your.module.name（名称不影响代理，但必须存在） - 验证是否生效：执行
go env GOPROXY，应返回你设置的地址（如https://goproxy.cn），而非默认值
GOPROXY 设置后仍报 403 Forbidden 或超时怎么办？
常见于国内私有代理（如 goproxy.cn、proxy.golang.org）被公司防火墙拦截，或代理本身不支持某些模块路径（例如含特殊字符、私有域名）。关键不是换代理，而是让 Go 明确知道哪些域名该直连。
推荐组合配置（用 | 分隔多个代理，direct 表示直连）：
go env -w GOPROXY="https://goproxy.cn,direct"
含义：先尝试 goproxy.cn，失败则跳过代理、直接连原始域名（如 gitlab.example.com）。
- 私有模块必须直连：若依赖
gitlab.internal/mylib，需确保该域名在GOPROXY列表末尾加direct，否则 Go 会试图用代理请求它并失败 - 避免通配符陷阱：不要写
GOPROXY=https://goproxy.cn,https://proxy.golang.org,direct—— 第二个代理失败后不会自动 fallback 到direct，而是整体失败 - 调试技巧：设
go env -w GODEBUG=httpclient=1后运行go mod download，可看到实际发起的 HTTP 请求地址
为什么 go get 成功但 go mod vendor 仍拉不到依赖？
因为 go mod vendor 默认只打包 go list -deps -f '{{.ImportPath}}' . 的结果，而 go get 可能引入了未被主模块 import 的间接依赖（比如测试用的工具库）。vendor 目录缺失，本质是依赖图未完整解析。
解决办法不是重跑 go get，而是强制刷新依赖树：
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
go mod tidy && go mod vendor
go mod tidy 会清理未引用的依赖，并补全所有 transitive 依赖（包括 test-only 的），这才是 vendor 的输入源。
- 检查遗漏项：运行
go list -m all | grep 'your-missing-module'，若无输出，说明tidy未将其纳入 - 手动触发：如果某个模块仅在
_test.go中 import，需确保当前目录下有go test -v能跑通，否则tidy会忽略它 - vendor 路径固定：生成后所有依赖都在
./vendor，后续构建不再走网络——这点常被忽略，导致误以为“vendor 没生效”
公司内网用 Nexus 搭建 Go 代理，但 go mod download 报 x509: certificate signed by unknown authority
不是证书问题本身，而是 Go 默认不读取系统 CA 证书（尤其在 Linux 容器或 macOS 新版中）。Nexus 自签证书必须显式注入到 Go 的信任链。
最稳妥做法：导出 Nexus 的根证书（PEM 格式），合并进 Go 的 certs 文件：
cat nexus-ca.crt >> $(go env GOROOT)/ssl/cert.pem
注意：GOROOT 是 Go 安装路径，不是 HOME；ssl/cert.pem 是 Go 内置证书文件名，不可改。
- 验证路径：运行
go env GOROOT确认位置，常见为/usr/local/go或~/sdk/go - 容器场景：Dockerfile 中需在
go install后追加证书，不能只改宿主机 - 替代方案（不推荐）：设
GOINSECURE="nexus.internal"，但仅适用于 HTTP 或测试环境，生产禁用
模块路径错误的本质，从来不是路径拼写问题，而是 Go 在不同模式（GOPATH vs module）、不同上下文（main module vs subpackage）、不同网络策略（proxy vs direct）下的行为切换没被显式控制住。每一步都要验证当前环境的真实状态，而不是假设配置已生效。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
