首先初始化模块并编写可导出函数，接着添加测试和文档，最后打标签推送到GitHub实现发布。具体步骤为：1. 使用go mod init创建go.mod文件；2. 编写首字母大写的公开函数如Reverse；3. 创建reverse_test.go并运行go test验证功能；4. 将代码推送到GitHub并打v1.0.0版本标签；5. 添加README.md和示例提升可用性，发布后可被pkg.go.dev收录供全球使用。
在 Golang 中编写可复用模块，核心在于合理组织代码结构、定义清晰的接口，并通过 Go Modules 管理依赖。无论是供团队内部使用还是发布到公共生态，一个设计良好的模块能显著提升开发效率。下面详细介绍如何创建并发布一个自定义的 Go 模块。
初始化模块：使用 go mod init
要创建一个可复用的 Go 模块，第一步是初始化 go.mod 文件，它用来声明模块路径和管理依赖。
假设你想创建一个名为 github.com/yourname/stringutil 的工具模块，操作如下：
- 新建项目目录：mkdir stringutil && cd stringutil
- 初始化模块：go mod init github.com/yourname/stringutil
执行后会生成一个 go.mod 文件，内容类似：
立即学习“go语言免费学习笔记（深入）”；
module github.com/yourname/stringutil go 1.20
这个模块路径也是别人导入你模块时使用的路径。
编写可导出的函数与结构体
Go 的可见性由标识符首字母决定：大写为公开（可被外部包调用），小写为私有。
在根目录下创建 reverse.go 文件：
package stringutil
// Reverse 返回输入字符串的倒序
func Reverse(s string) string {
runes := []rune(s)
for i, j := 0, len(runes)-1; i < j; i, j = i+1, j-1 {
runes[i], runes[j] = runes[j], runes[i]
}
return string(runes)
}
注意：
- 包名是 stringutil，与模块名保持一致更清晰
- 函数 Reverse 首字母大写，表示可被外部调用
- 添加了注释，go doc 和 IDE 可自动识别
测试你的模块
良好的模块必须包含单元测试。创建 reverse_test.go：
package stringutil
import "testing"
func TestReverse(t *testing.T) {
cases := []struct {
in, want string
}{
{"hello", "olleh"},
{"Go", "oG"},
{"", ""},
}
for _, c := range cases {
got := Reverse(c.in)
if got != c.want {
t.Errorf("Reverse(%q) == %q, want %q", c.in, got, c.want)
}
}
}
运行测试：go test，确保输出 OK。
发布模块：打 Tag 并推送到 GitHub
Go 模块通过版本标签（如 v1.0.0）来管理发布版本。
- 将代码推送到 GitHub：
git init
git add .
git commit -m "Initial commit"
git remote add origin https://github.com/yourname/stringutil.git
git push -u origin main - 打版本标签：
git tag v1.0.0
git push origin v1.0.0
之后，其他人就可以通过以下方式导入：
import "github.com/yourname/stringutil"
result := stringutil.Reverse("golang")
优化模块可用性
为了让模块更易用，建议：
- 在根目录添加 README.md，说明用途、安装方式和示例
- 提供示例代码（放在 examples/ 目录）
- 使用 go vet 和 golint 检查代码质量
- 考虑语义化版本控制（SemVer）管理更新
基本上就这些。只要遵循 Go 的模块规范，写出简洁、有测试、文档清晰的代码，你的模块就能轻松被复用和分享。发布后，还可以被 pkg.go.dev 自动收录，供全球开发者查阅。
