发布模块

当你想让一个模块可供其他开发人员使用时,你可以发布它,以便对 Go 工具可见。发布模块后,导入其包的开发人员将能够通过运行 go get 等命令来解决对模块的依赖关系.

注意: 发布后不要更改模块的标记版本。对于使用该模块的开发人员,Go 工具会根据第一个下载的副本对下载的模块进行身份验证。如果两者不同,Go 工具将返回安全错误。不要更改以前发布版本的代码,而是发布一个新版本。

另请参见

发布步骤

使用以下步骤发布模块.

  1. 打开命令提示符并切换到本地存储库中模块的根目录。

  2. 运行 go mod tidy, 它会删除模块可能积累的不再需要的任何依赖项。

    $ go mod tidy
    
  3. 运行 go test ./... 最后一次确保一切正常.

    这将运行您为使用 Go 测试框架而编写的单元测试。

    $ go test ./...
    ok      example.com/mymodule       0.015s
    
  4. 使用 git tag命令使用新版本号标记项目。

    对于版本号,请使用一个向用户表明此版本中更改性质的数字。有关更多信息,请参阅模块版本编号

    $ git commit -m "mymodule: changes for v0.1.0"
    $ git tag v0.1.0
    
  5. 将新tab推送到源存储库。

    $ git push origin v0.1.0
    
  6. 通过运行go list 命令提示 Go 使用您正在发布的模块的信息更新其模块索引,从而使模块可用.

    在命令前加上一条语句,将GOPROXY 环境变量设置为 Go 代理。这将确保您的请求到达代理。

    $ GOPROXY=proxy.golang.org go list -m example.com/mymodule@v0.1.0
    

对您的模块感兴趣的开发人员从中导入一个包并运行go get 命令 ,就像他们对任何其他模块一样。他们可以针对最新版本运行go get 命令,也可以指定特定版本,如下例所示:

$ go get example.com/mymodule@v0.1.0