Go模块无需中心仓库，只需Git路径与go.mod中模块名一致并打语义化tag即可被go get导入；模块名须为可解析的远程地址，首字母大写的标识符才可导出。
Go 模块（go module）不是“发布后才能导入”的中心化机制，而是基于版本控制路径 + 语义化版本的本地可构建系统。只要模块有公开可访问的 Git 仓库（如 GitHub、GitLab、私有 Gitea），其他项目就能直接 go get 导入——无需上传到任何中心仓库。
如何初始化一个可复用的 Go 模块
模块名必须是能解析的、稳定的导入路径，通常对应远程仓库地址（例如 github.com/yourname/utils），而不是本地文件路径。
- 在项目根目录执行
go mod init github.com/yourname/utils，生成go.mod - 模块名一旦写入
go.mod，所有内部import都需以它为前缀（如import "github.com/yourname/utils/stringutil"） - 避免使用
go mod init自动推断的本地路径（如myproject），否则别人go get时会找不到依赖 - 导出的函数/类型首字母必须大写；未导出的（小写开头）对外不可见
如何让别人能 go get 成功导入你的模块
关键是让 Go 工具链能通过模块路径定位到 Git 仓库，并拉取带 vX.Y.Z tag 的稳定版本。
- 把代码推送到公开 Git 服务，路径需与
go.mod中模块名完全一致（大小写、斜杠都不能错） - 打语义化版本 tag：例如
git tag v0.1.0 && git push origin v0.1.0（注意v前缀不能少） - 确保
go.mod文件已提交，且其中module行与仓库地址一致 - 他人导入时直接写
import "github.com/yourname/utils"，运行go build或go run会自动go get最新 tag - 若想指定版本，可在
go get时加后缀：go get github.com/yourname/utils@v0.1.0
常见失败原因和调试方法
报错如 unknown revision v0.1.0 或 cannot find module providing package，多数不是 Go 问题，而是路径或版本管理疏漏。
立即学习“go语言免费学习笔记（深入）”；
-
go list -m -f '{{.Dir}}' github.com/yourname/utils：检查本地缓存路径是否正确 -
go get -u -v github.com/yourname/utils@v0.1.0加-v看详细日志，确认是否卡在 Git clone 或 tag 解析 - 私有仓库需配置
git config --global url."https://token:x-oauth-basic@github.com/".insteadOf "https://github.com/"（GitHub PAT）或设置~/.netrc - 如果模块路径含公司内网域名（如
git.internal.company.com/myteam/lib），调用方需确保该域名可解析且 Git 可访问 - Go 默认只信任
v1.0.0及以上为正式版；v0.x.y属于预发布，go get会默认拉最新v0，但不会自动升级到v1
package main
import (
"fmt"
"github.com/yourname/utils/stringutil"
)
func main() {
fmt.Println(stringutil.Reverse("hello")) // 输出: "olleh"
}
模块复用的核心不在“发布”，而在路径可信、版本可溯、接口稳定。很多人卡在第一步——模块名和 Git 地址不一致，导致 go get 根本无从下手。盯住 go.mod 第一行，把它当成 URL 而不是包名来看待，就对了一大半。
