harbor 不支持 go module proxy；它不实现 go proxy 协议接口，无法响应 go get 请求，只能通过 generic 项目上传 zip 包、配合 replace 和手动下载解压方式离线管理 go 模块，并需关闭 gosumdb 或手动维护 go.sum。
Harbor 支持 Go module proxy 吗？
不支持。Harbor 本身不是 Go module proxy，它不实现 GET /mod/xxx 或 GET /info/xxx 等 Go proxy 协议接口，也不能直接响应 go get 的模块发现请求。硬配 GOPROXY=https://your-harbor.example.com 会直接 404 或 401。
那怎么让 Harbor “托管” Go 模块？
实际可行的方式是：把编译好的二进制或源码 zip 包作为普通 artifact 上传到 Harbor 的 helm、oci 或（更常用）generic 项目中，再通过 Go 的 replace 或 require + version 配合本地 go mod download -json 手动注入。本质是“离线依赖管理”，不是实时 proxy。
- 推荐使用
generic项目类型：无格式限制，可上传module-v1.2.3.zip和对应go.mod文件 - 上传路径建议按
org/repo/v1.2.3/层级组织，例如myapp/utils/v0.5.0/utils-v0.5.0.zip - 必须确保 zip 内顶层目录结构符合 Go module 要求（含
go.mod，且 module path 与 zip 名/路径一致） - Harbor 的
OCI artifact类型也能存 Go module（需打包为 OCI image，用oras push），但构建和拉取链路更重，日常开发少用
如何在项目里引用 Harbor 上的 Go 模块？
靠 replace 指向本地解压路径，或用 go mod edit -replace 绑定到一个临时本地路径，再配合脚本从 Harbor 下载并解压。不能用 import path 直接指向 Harbor URL。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 先用
curl -u user:pass https://harbor.example.com/api/v2.0/projects/my-go-modules/repositories/utils/artifacts?with_tag=true查 tag 列表 - 下载 zip：
curl -u user:pass -o utils-v0.5.0.zip 'https://harbor.example.com/api/v2.0/projects/my-go-modules/repositories/utils/artifacts/v0.5.0/files?format=zip' - 解压后执行：
go mod edit -replace github.com/org/utils=./local-utils（注意路径必须存在且含有效go.mod） - CI 中建议封装成小脚本：下载 → 校验 SHA256（从 Harbor API 获取 digest）→ 解压 → replace →
go build
为什么不用 GOPROXY + 自建 Athens 或 JFrog？
因为 Harbor 定位是容器镜像与通用 artifact 仓库，不是语言生态 proxy。如果真需要透明 proxy 行为（比如 go get github.com/foo/bar 自动回源+缓存），就得在 Harbor 前面加一层 athens 或 jfrog artifactory，并配置其 upstream 为 public proxy（如 https://proxy.golang.org）和 Harbor 的 generic endpoint（需反向代理适配路径）。但这已超出 Harbor 原生能力，属于架构组合问题。
真正容易被忽略的是：Go module 的 sum.db 校验机制对非标准 proxy 返回的 checksum 不兼容——Harbor 上传的 zip 没有自动写入 sum.golang.org 记录，所以必须关掉校验（GOSUMDB=off）或自己维护 go.sum 文件并 commit 进 repo。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
