Golang module如何发布与引用

答案：发布Go module需初始化模块、编写导出代码、Git托管、打版本标签、支持语义化版本及可选提交至pkg.go.dev。1. 执行go mod init创建go.mod；2. 编写大写字母开头的公开函数如Hello；3. 使用git推送代码到GitHub等平台；4. 打v1.0.0格式标签并推送；5. 升级v2+时在模块路径添加/v2；6. 公开仓库后pkg.go.dev自动收录文档；7. 外部通过go get引用指定版本。

Golang 中编写并发布一个可被外部引用的 module，需要遵循标准的模块管理机制。整个流程包括初始化模块、编写代码、版本控制、打标签以及让模块可被发现和下载。下面是一个清晰、实用的操作流程。

1. 初始化 Go Module

在项目根目录下执行 go mod init 命令来创建一个新的模块。

假设你的模块名为 github.com/yourname/mymodule：

mkdir mymodule && cd mymodule
go mod init github.com/yourname/mymodule

这会生成一个 go.mod 文件，内容类似：

module github.com/yourname/mymodule

go 1.20

2. 编写可导出的代码

Go 中大写字母开头的函数、类型、变量等是对外公开的（可导出）。例如：

// file: hello.go
package mymodule

import "fmt"

func Hello(name string) string {
    return fmt.Sprintf("Hello, %s!", name)
}

外部项目导入你这个模块后，就可以使用 mymodule.Hello("Alice")。

3. 使用 Git 管理源码

Go modules 依赖 Git 来拉取代码，因此必须将项目托管在支持 Git 的平台（如 GitHub、GitLab）。

git init
git add .
git commit -m "Initial commit"
git remote add origin https://github.com/yourname/mymodule.git
git push -u origin main

4. 打版本标签（Tag）

Go modules 使用语义化版本（Semantic Versioning），必须打 tag 才能被正式引用。

git tag v1.0.0
git push origin v1.0.0

之后发布的版本可以是：

• v1.0.1：修复 bug
• v1.1.0：新增功能
• v2.0.0：不兼容变更（注意 major 版本）

5. 支持 Major 版本升级（如 v2+）

如果你要发布 v2 或更高版本，需在 go.mod 中包含版本号：

go mod init github.com/yourname/mymodule/v2

同时代码中的 import 路径也要带上 /v2，否则 Go 会认为是不同模块。

6. 让模块可被发现（可选）

你可以将模块提交到 Go 官方代理服务：

• pkg.go.dev

只要模块是公开的，且已打 tag，访问以下地址即可查看文档：

https://pkg.go.dev/github.com/yourname/mymodule

pkg.go.dev 会自动抓取并生成 API 文档。

7. 外部如何引用你的模块

其他开发者可以通过以下方式引入：

go get github.com/yourname/mymodule@v1.0.0

然后在代码中使用：

package main

import (
    "fmt"
    "github.com/yourname/mymodule"
)

func main() {
    fmt.Println(mymodule.Hello("World"))
}

基本上就这些。整个过程不复杂但容易忽略 tag 或路径规范。