使用Nexus搭建Golang模块依赖管理私有源的保姆级教程-Golang-PHP中文网

go_proxy必须以斜杠结尾，nexus需安装匹配版本的nexus-golang-plugin并创建go(proxy)类型仓库，remote storage设为https://proxy.golang.org/且禁用严格内容校验，私有模块需配置go_private和no_proxy。

使用nexus搭建golang模块依赖管理私有源的保姆级教程

GO_PROXY 必须以斜杠结尾，否则所有模块请求都会 404 —— 这不是 Nexus 配置错，是 Go 客户端硬编码的路径拼接逻辑决定的。

Nexus OSS 3.x 默认不支持 Go 模块语义（如 @v/list、@v/v1.2.3.info），必须手动安装插件。没装插件，新建仓库时根本不会出现 go (proxy) 类型选项。

Go 客户端只认标准 upstream 地址；用阿里镜像或 goproxy.io 作为 remote，会导致部分模块（尤其是带 golang.org/x/ 子路径的）返回 404 或校验失败。

Golang Naming

Go（Golang）命名规范 — 包括包、构造函数、结构体、接口、常量、枚举、错误、布尔值、接收器、getter/setter、函数等。

下载

Remote storage location 填 https://proxy.golang.org/（协议必须是 https）
勾选 Disable Strict Content Validation，否则某些模块因响应头缺失 Content-Type: application/json 被拒
Public URL 显示为 http://localhost:8081/repository/golang-proxy/（注意末尾斜杠）
不要加 /v2、/api 等后缀——Go 会原样拼接，比如请求 github.com/go-yaml/yaml/@v/v1.2.3.mod，缺斜杠就变成 /golang-proxygithub.com/...

Go 客户端对 GO_PROXY 值做纯字符串拼接，不作任何路径规范化。漏掉斜杠或写成 HTTP，直接导致所有模块拉取失败。

正确写法：export GO_PROXY="http://localhost:8081/repository/golang-proxy/"（末尾 / 不可省）
HTTPS 更安全，但若 Nexus 未配 TLS，则必须用 http:// + ,direct 后缀，否则 Go 拒绝连接
验证方式：curl -I "$GO_PROXY/github.com/gorilla/mux/@v/list" 应返回 200 OK 和 Content-Type: text/plain; charset=utf-8
避免被覆盖：运行 go env GOPROXY 确认当前生效值，不是 go env -w 的写入记录

只设 GO_PROXY，Go 仍会把 gitlab.company.com/mylib 这类地址发给代理，结果要么 404，要么卡住超时。

export GO_PRIVATE="gitlab.company.com"（支持通配符，如 *.company.com）
export NO_PROXY="gitlab.company.com"（告诉 Go 不走代理，直连 Git 服务器）
若 Nexus 启用了身份验证，Go 不自动传凭据，需额外配置 ~/.netrc 文件，内容为：machine gitlab.company.com login user password token-xxx
私有模块的 module 名必须与 Git 地址完全一致，例如 go mod init gitlab.company.com/team/utils