跳到主要内容
版本：2.9.x(Latest)

Go Module 是从 Go 版本 1.11.1 开始官方提供的包管理工具，用于解决Go项目的包管理及依赖，类似于PHP的 composer、Nodejs的 npm。

本章节会对 Go Module 的一些常用的实用的命令/设置进行介绍，更详细的介绍请查看官方文档： https://go.dev/wiki/Modules

关于 go.mod​

go.mod 是 Go 项目的依赖描述文件，该文件主要用来描述两个事情：

  1. 当前项目名( module)是什么。每个项目都应该设置一个名称，当前项目中的包( package)可以使用该名称进行相互调用。
  2. 当前项目依赖的第三方包名称。项目运行时会自动分析项目中的代码依赖，生成 go.sum 依赖分析结果，随后 go 编译器会去下载这些第三方包，然后再编译运行。

我们可以看到之前的 hello world 项目下有一个自动生成的 go.mod 文件，其内容如下：

module hello

其中， hello 为当前项目的名称，在我们初始化项目的时候Goland IDE自动帮助我们生成了该文件，默认情况下该module的名称为目录的名称，该名称可以随意设置。

关于GOPROXY​

GOPROXY 是一个环境变量，用于设置代理地址加速下载依赖或下载自己的私有依赖。

详见 Go 官网说明： https://go.dev/wiki/Modules

常见的公共GOPROXY反向代理地址有：

使用 go.mod​

使用 Goland IDE​

  1. 设置 Goland 启用 Go Module特性

    alt text

    在下载第三方依赖包时，您需要科学上网。笔者本地设置了一个环境变量GOPROXY用于科学上网拉取依赖：

    GOPROXY=https://goproxy.cn

    如果您本地环境已经有 VPN 功能，那么可以忽略 GOPROXY 的设置，可以添加direct 后缀表示不使用代理。

    GOPROXY=https://goproxy.cn,direct

  2. 手动修改 go.mod 文件如下：

    module hello

    require github.com/gogf/gf/v2 latest

    增加 GoFrame 框架的依赖，其中 latest 表示使用github.com/gogf/gf/v2最新版本，IDE将会立即去更新下载框架代码。成功后，IDE将会修改 go.mod 文件并生成 go.sum 依赖分析文件。该go.sum文件为该项目所有的第三方依赖，通常也应该推送到版本管理仓库中。

  3. 随后 go.mod 文件被自动更新为：

    module hello

    require github.com/gogf/gf/v2 v2.8.1

    其中 v2.8.1 表示Go Module检测到的最新框架版本。

使用命令行​

  1. 打开 Terminal，在项目根目录下执行:

    go env -w GO111MODULE=on
    go env -w GOPROXY=https://goproxy.cn,direct
    go get -u github.com/gogf/gf/v2

    推荐使用go env -w的方式设置Go的环境变量（其他方式请参考），以上命令将会使用代理立即下载最新稳定版本的 GoFrame 框架。

  2. 随后 go.mod 文件内容被自动更新为：

    module hello


    require github.com/gogf/gf/v2 v2.8.1

    且生成了新的 go.sum 依赖分析文件。

Ask me