初始化Go模块需用go mod init github.com/yourname/mylib确保module path与托管URL一致；打tag必须为v1.0.0格式并推送远程；go.dev索引要求仓库公开、path匹配、有合法v* tag；unknown revision多因tag缺v前缀或path不匹配。
如何初始化 Go 模块并设置正确 module path
Go 模块的发布起点是 go mod init，但关键在 module path 的选择——它必须与你未来托管代码的 URL 一致，否则下游用户 go get 会失败或拉取到错误版本。比如你要把模块放在 GitHub 上，地址是 https://github.com/yourname/mylib，那么初始化时必须用：
go mod init github.com/yourname/mylib
而不是 go mod init mylib 或 go mod init ./mylib。本地路径、相对路径、不带域名的名称都会导致后续 go get 解析失败。
如何打语义化版本 tag 并确保 go list 能识别
Go 不依赖 package.json 那类元文件，而是直接从 Git tag 读取版本。必须使用符合 SemVer 的格式（如 v1.0.0、v0.5.2），开头带 v 是硬性要求。打 tag 后需推送到远程：
git tag v0.1.0
git push origin v0.1.0
验证是否生效，可在另一目录运行：
go list -m -versions github.com/yourname/mylib
如果返回空或报错 no matching versions，常见原因有：tag 未推送、tag 名字不含 v、仓库未公开（私有仓库需额外配置 GOPROXY 或 GOPRIVATE）、模块根目录下没有 go.mod 文件。
如何让 go.dev 和 pkg.go.dev 正确索引你的模块
go.dev 本身不托管代码，只抓取公开 Git 仓库的 tag 和文档。要让它显示你的模块页面和 API 文档，只需满足三点：
• 仓库为公开（GitHub/GitLab 等）
• module path 与仓库地址完全匹配
• 至少有一个合法的 v* tag 已推送
首次提交后，索引可能延迟几分钟到几小时；若超 24 小时仍未出现，检查 go list -m -json github.com/yourname/[email protected] 是否能正常返回信息。注意：go.dev 不支持子模块路径（如 github.com/yourname/mylib/sub）独立索引，整个仓库以主 module path 为准。
