GOPRIVATE 是 Go 1.13 引入的环境变量，用于声明私有模块路径前缀（支持末尾通配符），使匹配模块跳过公共代理和 checksum 校验，直接通过 Git 下载；需配合 GOPROXY="...,direct" 使用，并验证凭据与路径正确性。
要让 Go 工具链正确拉取私有仓库的模块，关键不是改代码，而是配置环境变量 GOPRIVATE，告诉 go 命令“哪些域名下的模块不走公共代理、不校验 checksum、直接走 git 协议拉取”。
什么是 GOPRIVATE？
GOPRIVATE 是 Go 1.13 引入的环境变量，用于声明一组模块路径前缀（支持通配符），匹配上的模块将：
- 跳过
proxy.golang.org和sum.golang.org - 不校验 module checksum（因为私有库通常没发布到 checksum 服务）
- 直接通过 Git（如 HTTPS 或 SSH）下载源码
它不影响你写代码或 import 路径，只影响 go get、go build 等命令的依赖解析行为。
如何设置 GOPRIVATE
在 shell 中设置（Linux/macOS）：
立即学习“go语言免费学习笔记（深入）”；
export GOPRIVATE="git.example.com,github.com/myorg/*,gitee.com/private"
Windows（PowerShell）：
$env:GOPRIVATE="git.example.com,github.com/myorg/*"
推荐写入 shell 配置文件（如 ~/.zshrc）或系统级环境变量，避免每次重设。
注意：
– 多个域名/路径用英文逗号分隔，不能有空格；
– 支持通配符 *，但仅用于路径末尾（如 github.com/myorg/*），不支持中间或开头；
– 如果你的私有模块路径是 git.example.com/team/project，只需填 git.example.com 即可匹配所有子路径。
配合 GOPROXY 使用更稳妥
即使设置了 GOPRIVATE，仍建议显式配置 GOPROXY，避免因公司网络策略或本地误配导致 fallback 到公共代理：
export GOPROXY="https://proxy.golang.org,direct"
其中 direct 表示“对 GOPRIVATE 匹配的模块，直接连接源站”，这是 go 默认行为，但显式写出更清晰。也可以换成内部镜像地址（如 https://goproxy.yourcorp.com），前提是该镜像已支持私有库透传或白名单机制。
验证是否生效
运行以下命令检查当前配置：
go env GOPRIVATE GOPROXY
然后尝试拉取一个私有模块：
go get git.example.com/team/internal-utils@v0.2.0
如果看到 Cloning into ... 或成功下载，说明配置已起作用；若报错 unknown revision 或 403 Forbidden，请检查：
– Git 凭据是否已配置（如 git config --global credential.helper store）
– SSH key 是否添加到对应平台（GitHub/GitLab/Gitee）
– 模块路径是否拼写正确（区分大小写、组织名是否准确）
基本上就这些。不需要改 go.mod，也不用动 go 工具源码，纯靠环境变量驱动，简单但容易忽略细节。
