Go中创建可复用模块需正确使用Go Modules，核心是规范module path（如github.com/yourname/mylib）、严格遵循SemVer版本格式（v1.2.0）、提交go.mod/go.sum、提供README和注释，并推送至Git平台以支持go get和pkg.go.dev索引。
在 Go 中创建可复用模块，核心是正确使用 Go Modules —— 它不仅是依赖管理工具，更是模块发布、版本控制和公共分发的基础机制。关键不在于写多复杂的代码，而在于模块路径设计、语义化版本（SemVer）实践、以及符合 Go 生态的发布习惯。
模块初始化：选对 module path 是第一步
模块路径（module path）是模块的唯一标识，通常应为一个可解析的 URL（即使不托管在该域名下），例如：github.com/yourname/mylib。它决定了：
- 其他项目导入时的 import 路径
- Go 工具链如何定位、校验和缓存模块
- 是否能被
pkg.go.dev正确索引
初始化命令很简单：
go mod init github.com/yourname/mylib
立即学习“go语言免费学习笔记（深入）”；
⚠️ 注意：不要用本地路径（如 ./mylib）或无域名格式（如 mylib）。否则无法被他人正确引用，也不符合发布规范。
版本号必须遵循 SemVer v1.0.0+ 格式
Go 官方强制要求模块版本号采用语义化版本（MAJOR.MINOR.PATCH），例如 v1.2.0、v2.0.0。版本号直接体现在 tag 名称中，且必须带 v 前缀。
|Git删除了文件，但还会在Git 仓库历史中遗留。 - 想要从 Git 历史移除敏感信息（密码、密钥、token、私钥） - 想要删除意外提交的大文件 - 想要重写 Git 历史、移除特定文件的所有痕迹 - 提到 "force push"、"重写 commit 历史" - 需要从所有分支、所有 tag 中删除某个文件
- v1.x.x：默认主版本，无需在 import 路径中体现
-
v2.0.0+：主版本升级需在 module path 末尾加
/v2，例如github.com/yourname/mylib/v2 - 不支持
v1.2这类省略 PATCH 的写法；v1.2.0-rc1等预发布版本会被自动识别为“不稳定”，排序低于正式版
打 tag 示例：
git tag v1.0.0
git push origin v1.0.0
发布前检查：go.mod + go.sum + 文档缺一不可
一个可复用的模块，除了代码本身，还需满足基本可用性门槛：
-
go.mod中的module声明与实际 Git 仓库地址一致 -
go.sum提交到仓库（尤其对私有模块或 CI 场景很重要） - 根目录提供
README.md，含安装方式（go get）、简短示例、API 概览 - 导出的 API 有清晰注释（会被
pkg.go.dev自动抓取生成文档） - 避免在
main包中写库逻辑；库代码应放在package mylib下
让模块被发现：推送到公开 Git 服务 + 注册 pkg.go.dev
Go 模块本身不依赖中心仓库（如 npm registry），而是通过 Git（GitHub/GitLab/Codeberg 等）托管源码。只要满足上述规范，用户就能直接 go get：
go get github.com/yourname/mylib@v1.0.0
想提升可见性？访问 pkg.go.dev，搜索你的模块路径，点击 “Request documentation” 即可触发自动索引（首次可能需数分钟）。索引成功后会显示完整 API 文档、版本历史、导入统计等。
基本上就这些。不复杂但容易忽略细节 —— 尤其是 module path 和 v2+ 路径规则，一旦错，下游就无法干净升级。
