go模块发布需将代码推至公开git服务器并打语义化版本标签，module路径须与git地址严格一致，且标签格式为vx.y.z；私有域名需配置goinsecure或代理，子模块需独立路径并显式声明v2等主版本。
Go 模块发布不是上传到中心仓库，而是把代码推送到公开可访问的 Git 服务器（如 GitHub），再通过 Go 的模块代理和版本标签自动发现——go get 能直接拉取，前提是你的仓库支持 HTTPS + Git 协议，且有合规的 go.mod 和语义化版本标签。
模块路径必须与代码托管地址严格匹配
模块路径（module 声明）不是随意起的，它必须和你最终公开的 Git 地址一致。比如你把代码放在 https://github.com/yourname/mypkg，那 go.mod 里就得写：
module github.com/yourname/mypkg
如果写成 module mypkg 或 module gitlab.com/yourname/mypkg，go get 会失败或拉错源。Go 不做重定向解析，只按字面路径找对应 Git 服务。
- 私有域名（如公司内网）需额外配置
GOINSECURE或私有代理，否则go get拒绝 HTTP 或自签名证书 - 路径中不能含大写字母或下划线（Go 规范要求，否则
go list -m会报错） - 子模块路径（如
github.com/yourname/mypkg/v2）需独立仓库或使用/v2子目录，且v2必须出现在module行和所有 import 路径中
必须打符合语义化版本的 Git 标签
Go 模块依赖版本识别完全靠 Git tag，不是分支名或 commit hash（除非显式指定）。tag 名必须是 vX.Y.Z 格式（如 v1.0.0），前面带 v，且只能是数字点分隔。
立即学习“go语言免费学习笔记（深入）”；
-
git tag v1.0.0 && git push origin v1.0.0是最小必要操作；不 push tag，别人go get只能看到latest（即 main 分支最新 commit） -
v1、1.0.0、release-1.0都无效，会被go list -m -versions忽略 - 主版本升级（如
v1→v2）必须改module路径，否则 Go 认为是同一版本系列，不会自动升级
go.mod 文件要干净且最小化
go.mod 是模块的唯一元数据来源，go get 和 go list 全靠它判断兼容性。发布前务必运行：
go mod tidy
确保没有冗余 require 或 replace。尤其注意：
-
replace是开发期临时方案，发布前必须删掉，否则下游go build会尝试拉被 replace 掉的模块，而它可能不可达 -
go.sum不需要提交（虽然常见），但若提交了，确保它和go.mod一致；CI 中建议用go mod verify校验 - Go 版本声明（
go 1.21）应设为你实际测试过的最低版本，太高会限制用户，太低可能触发旧版 bug
最容易被忽略的是：模块发布后第一次被他人 go get 时，Go 默认走 proxy.golang.org 缓存，而它只缓存已存在 tag 的版本。如果你刚 push 了 v1.0.0，但没等代理同步（通常几秒到几分钟），别人可能看到 “no matching versions” 错误——这不是你代码问题，而是缓存延迟；此时加 -insecure 或直连 git 可绕过，但更稳妥的做法是本地先 go get yourmodule@v1.0.0 验证能拉通再通知用户。
