要让别人能 go get 到你的库，核心是代码必须托管在公开、支持 HTTPS 的 Git 服务上且路径与模块名一致；需设仓库为 public、用 go mod init 初始化、打语义化 tag、写全 go.mod 并运行 go mod tidy；文档需符合注释规范且主分支能通过 go build/test；proxy 缓存会导致新 tag 延迟可达 30 分钟。
怎么让别人能 go get 到你的库
核心就一条：代码必须托管在公开、支持 HTTPS 的 Git 服务上，且路径要和模块名一致。比如你想发布模块名是 github.com/yourname/mylib，那代码就得放在这个 URL 对应的公开仓库里。
常见错误现象：go get github.com/yourname/mylib 报错 unknown revision 或直接超时——大概率是仓库私有、URL 拼错、没打 tag，或者用了非标准域名（比如自建 GitLab 但没配 GOPROXY 兼容）。
- 确保仓库设为 public，不是 internal 或 private
- 模块初始化用
go mod init github.com/yourname/mylib，别写成mylib或本地路径 - 首次发布前至少打一个语义化 tag，比如
v0.1.0；go get默认拉最新 tag，没 tag 就拉main分支的 HEAD，但很多用户会关掉GO111MODULE=off或用旧版 Go，容易出兼容问题
为什么要写 go.mod 且不能漏掉 require 声明
不写 go.mod，你的库对使用者就是“不可版本化”的黑盒。Go 生态依赖模块感知来解析依赖树、做最小版本选择（MVS），缺了它，别人 go get 后可能拉到不兼容的间接依赖，甚至编译失败。
使用场景：别人项目启用了 module（GO111MODULE=on），你没 go.mod，他们的 go.sum 就没法校验你库的依赖来源，CI 构建可能飘移。
立即学习“go语言免费学习笔记（深入）”；
-
go mod init后立刻运行go mod tidy，补全所有require行，包括测试依赖（如果用了_test包） - 别手动删
require里的// indirect标记——那是 Go 提示“这依赖没被直接 import”，但删了可能导致下游构建找不到包 - 如果你引用了还在开发中的其他模块，用
replace是临时方案，发布前必须去掉，否则别人go get会失败
为什么 go doc 和 pkg.go.dev 看不到你的文档
不是代码没注释，而是 pkg.go.dev 抓取有硬性条件：模块必须可公开 go get、有合法 go.mod、且主分支或最新 tag 的代码能通过 go build + go test（不含 build tags 排除的文件）。
性能影响：文档生成本身不耗资源，但若 go test 卡住（比如启了 HTTP server 或等网络），pkg.go.dev 会超时放弃索引，后续也不会重试——得手动触发刷新或推新 tag。
- 导出标识符（函数、类型、变量）的注释必须紧贴声明上方，且首句独立成行，以大写字母开头，句号结尾，例如：
// ParseURL parses a URL string and returns *url.URL.<br>func ParseURL(s string) (*url.URL, error) { ... } - 避免在
init()里做阻塞操作；pkg.go.dev不运行你的代码，但会调用go list -json，如果import链里有 panic 或死循环，索引直接失败 - 私有导入（如
import "internal/xxx"）不会被索引，但只要不破坏构建，不影响主文档生成
发布后别人 go get 到的版本为什么不是你刚 push 的
因为 Go 的 proxy 机制默认启用（GOPROXY=https://proxy.golang.org,direct），而 proxy.golang.org 缓存有 TTL，新 tag 上线后最长可能延迟 30 分钟才可见。这不是你代码的问题，是基础设施行为。
容易踩的坑：你在本地 go get -u 成功，就以为别人也能立刻拿到，结果协作者反馈“找不到 v0.2.0”。其实只是缓存没更新，或者他们用了私有 proxy 但没同步。
- 验证是否上线：访问
https://proxy.golang.org/github.com/yourname/mylib/@v/v0.2.0.info，返回 JSON 就说明已同步；404 则再等或换 direct 模式试 - 想跳过 proxy 直接拉源站，临时加
-d参数：go get -d github.com/yourname/mylib@v0.2.0，但别教用户这么用——影响构建稳定性 - CI 发布流程里，打 tag 后建议 sleep 60 秒再退出，给 proxy 留出缓冲时间
