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）：

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 工具源码，纯靠环境变量驱动，简单但容易忽略细节。