初始化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/mylib@v0.1.0 是否能正常返回信息。注意：go.dev 不支持子模块路径（如 github.com/yourname/mylib/sub）独立索引，整个仓库以主 module path 为准。
为什么 go get 失败却提示 “unknown revision”
这个错误几乎都指向版本不可达，不是网络问题。典型场景包括：
• 本地 go.mod 写了 require github.com/yourname/mylib v0.1.0，但远程没打 v0.1.0 tag，只打了 0.1.0（缺 v）
• 用了 replace 或 exclude 本地调试，但忘记删掉就推送了 go.mod
• 模块路径拼写错误，比如大小写不一致（GitHub 用户名区分大小写，但 go get 默认小写化处理，易出错）
• 使用了私有域名但未配置 GOPRIVATE=*.yourcompany.com
临时排查可用：go list -m -u -json github.com/yourname/mylib 查看实际解析到的源和版本范围。
立即学习“go语言免费学习笔记（深入）”；
模块发布最常卡在 module path 与 Git 地址不一致，以及 tag 缺少 v 前缀——这两点不修正，其他步骤全白做。