首先初始化模块并编写代码，使用 go mod init 创建模块并添加功能代码；接着将项目推送到 GitHub 公共仓库，确保仓库名称与模块路径一致；然后通过 git tag v1.0.0 等语义化版本标签发布版本，并推送标签到远程仓库；等待片刻后，proxy.golang.org 会自动索引该模块，可通过 pkg.go.dev 查看文档或在其他项目中导入使用；最后可选提交至 Go Discovery 等平台提升可见性。整个流程依赖公开仓库、规范的模块命名和正确的版本标签，即可实现包的发布与引用。

发布 Go 包到公共仓库（如 GitHub 和 Go Modules 兼容的代理，例如 proxy.golang.org）是一个标准流程。下面以发布一个简单的 Go 模块为例，说明从初始化到可被他人导入使用的完整步骤。

1. 初始化模块并编写代码

创建项目目录并使用 go mod init 初始化模块：

// 创建项目目录
mkdir my-awesome-package
cd my-awesome-package

// 初始化模块，命名通常为 github.com/你的用户名/仓库名
go mod init github.com/your-username/my-awesome-package

创建主包文件，例如 hello.go：

package hello

func SayHello() string {
  return “Hello from my awesome package!”
}

运行 go mod tidy 确保依赖正确：

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

go mod tidy

2. 推送到 GitHub 仓库

在 GitHub 上创建一个同名的公共仓库：my-awesome-package（确保是公开的，私有仓库不会被公共代理收录）。

将代码推送到远程仓库：

git init
git add .
git commit -m “Initial commit”
git remote add origin https://github.com/your-username/my-awesome-package.git
git push -u origin main

3. 打标签（Tag）发布版本

Go Modules 使用语义化版本（Semantic Versioning），你需要通过 Git 标签来发布版本。

Face++旷视

Face⁺⁺ AI开放平台

16

查看详情

例如，发布 v1.0.0 版本：

git tag v1.0.0
git push origin v1.0.0

后续更新可发布 v1.0.1、v1.1.0 等。注意：只有带 v 前缀的标签才会被 Go modules 识别。

4. 验证模块可被下载

等待几分钟后，Go 的公共代理（如 proxy.golang.org）会自动索引你的模块。你可以通过以下方式验证：

• 直接在浏览器访问：
  https://pkg.go.dev/github.com/your-username/my-awesome-package@v1.0.0
  如果页面显示文档，说明已成功收录。
• 在另一个项目中尝试引入：

package main

func main() {
  fmt.Println(hello.SayHello())
}

运行 go mod tidy，它会自动下载你的模块。

5. （可选）提交到 Go Discovery

为了让社区更容易发现你的包，可以提交到开源平台如：
https://www.php.cn/link/37654b793d96ed06d8c2bfa60658a502

填写项目信息后，有助于提升曝光度。

基本上就这些。只要你的仓库公开、模块命名规范、打上正确的版本标签，Go 工具链和公共代理就会自动处理剩下的事情。