确保 go.mod 配置正确，包括模块路径、依赖清理和明确 Go 版本；2. 提交所有代码变更；3. 使用 git tag -a 创建符合 vX.Y.Z 格式的语义化版本标签；4. 推送标签到远程仓库使模块代理索引；5. 通过 pkg.go.dev 或 go list 验证版本可用性；6. 主版本升级需修改模块路径，避免删除已发布标签，支持预发布版本。整个流程依赖 Git 标签实现自动版本分发。

在 Go 项目中使用模块（module）后，版本管理主要依赖于 Git 标签（tag）。Go 工具链会根据 Git 的语义化版本标签自动识别模块的不同版本。要为 Go 模块添加版本标签并发布，需遵循标准的发布流程和命名规范。

1. 确保 go.mod 文件正确配置

每个 Go 模块都有一个 go.mod 文件，它定义了模块路径、依赖项以及 Go 版本。发布前应确保该文件内容准确：

- 模块名称（module path）通常是代码仓库地址，如 github.com/username/projectname
- 所有依赖项已通过 go mod tidy 清理并锁定
- 使用的 Go 版本明确声明（如 go 1.21）

运行以下命令确保依赖整洁：

go mod tidy

2. 提交当前代码变更

在打标签之前，确保所有更改已提交到 Git 仓库：

立即学习“go语言免费学习笔记（深入）”；

git add .
git commit -m "Prepare for v1.0.0 release"

3. 创建语义化版本标签

Go 模块要求版本标签符合语义化版本规范（Semantic Versioning），格式为 vX.Y.Z，例如 v1.0.0、v0.1.2。必须以小写字母 v 开头。

创建轻量标签（lightweight tag）或附注标签（annotated tag）均可，推荐使用附注标签：

Investment Researcher Digital Employee

覆盖宏观策略、固收研究、行业公司深度分析、量化因子、大类资产配置、可转债、市场情绪、政策快评、行业景气度追踪等34项核心研究能力，证券研究员的全能数字助手。

下载

git tag -a v1.0.0 -m "Release version 1.0.0"

如果只是修复补丁，可递增 patch 版本：

git tag -a v1.0.1 -m "Fix critical bug in data processing"

4. 推送标签到远程仓库

仅本地打标签还不够，必须将标签推送到远程 Git 仓库（如 GitHub、GitLab）：

git push origin v1.0.0

或一次性推送所有标签：

git push origin --tags

推送完成后，Go 模块代理（如 proxy.golang.org）会在几分钟内索引新版本，其他开发者即可通过 go get 安装指定版本：

go get github.com/username/projectname@v1.0.0

5. 验证版本是否可用

可通过以下方式确认版本已生效：

- 访问 pkg.go.dev 并搜索你的模块名
- 使用 go list -m -versions <module-path></module-path> 查看可用版本
- 在新项目中尝试拉取指定版本测试

例如：

go list -m -versions github.com/yourname/yourmodule

6. 后续版本维护建议

- 主版本升级（如 v1 → v2）需改变模块路径（如添加 /v2 后缀）
- 不要删除已发布的标签，避免破坏依赖
- 可使用预发布标签，如 v1.0.0-beta.1

基本上就这些。只要按语义化版本规范打标签并推送到 Git，Go 模块系统就能自动识别和分发你的版本。整个过程简单透明，无需额外配置发布平台。