如何分享自己写的Go包给别人(含模块的创建、发布和引用方式)

gotest/
├── go.mod                 # 模块定义
├── main.go                # 主程序（可选）
└── mathutil/              # 一个可被外部使用的包
    └── mathutil.go

module gotest

go 1.26.1

package mathutil

// Add 返回两个整数的和
func Add(a, b int) int {
    return a + b
}

package main

import (
    "fmt"

    "gotest/mathutil"  // 模块名/包名
)

func main() {
    result := mathutil.Add(10, 20)
    fmt.Println("10 + 20 =", result)  // 输出: 10 + 20 = 30
}

module github.com/yourname/gotest

go 1.26.1

import "github.com/yourname/gotest/mathutil"

git init
git add .
git commit -m "初始提交"
git remote add origin https://github.com/yourname/gotest.git
git push -u origin main

# 打上版本标签（推荐语义化版本）
git tag v1.0.0
git push --tags

# 1. 下载你的包
go get github.com/yourname/gotest/mathutil

// 2. 在代码中导入
package main

import (
    "fmt"
    "github.com/yourname/gotest/mathutil"
)

func main() {
    fmt.Println(mathutil.Add(3, 5))  // 输出: 8
}

workspace/
├── gotest/                # 你分享的源码
│   ├── go.mod
│   └── mathutil/
│       └── mathutil.go
└── friend-project/        # 朋友自己的项目
    ├── go.mod
    └── main.go

module friend-project

go 1.26.1

require gotest v0.0.0

// 关键：用 replace 将模块名映射到本地路径
replace gotest => ../gotest

package main

import (
    "fmt"
    "gotest/mathutil"
)

func main() {
    fmt.Println(mathutil.Add(3, 5))  // 输出: 8
}