GO 项目依赖管理：go module总结

何彦熹 發表於 2023-6-18 00:45:00

转载请注明出处：
<h2 class="md-end-block md-heading">1.go module介绍</h2>
　　go module是go官方自带的go依赖管理库,在1.13版本正式推荐使用 go module可以将某个项目(文件夹)下的所有依赖整理成一个 go.mod 文件,里面写入了依赖的版本等使用go module之后我们可不用将代码放置在src下 使用 go module 管理依赖后会在项目根目录下生成两个文件 go.mod（会记录当前项目的所依赖）和go.sum（记录每个依赖库的版本和哈希值）
　　包管理工具go mod具有以下特性：
 　　　　1）自动下载依赖包，即第三方包。
 　　　　2）自定义包无须放在GOPATH设置的路径。
 　　　　3）第三方包或自定义包写在go.mod文件中，通过go.mod文件管理包。
 　　　　4）已经转移的第三方包或自定义包，在go.mod文件中使用replace替换，不需要修改代码。
 　　　　5）对第三方包指定版本号。
<h2 class="md-end-block md-heading">2.GO111MODULE配置</h2>
　　GO111MODULE 是 Go 1.11 版本后引入的模块管理功能。使用 GO111MODULE 可以让 Go 语言项目获得更好的包管理和版本控制功能。 GO111MODULE 的配置有以下几种：
<ol class="ol-list">
<li class="md-list-item">
auto：在 $GOPATH/src 之外的项目和使用了 Go 1.11 之前的依赖管理方式的项目开启模块支持，其他项目不开启。当项目在 <code>GOPATH/src</code> 目录之外,并且项目根目录有 <code>go.mod</code> 文件时，才开启 <code>go module</code>。
</li>
<li class="md-list-item">
on：开启模块支持，无论项目是否在 $GOPATH/src 下。启用 <code>go module</code>，编译时会忽略<code>GOPATH</code>和<code>vendor</code>文件夹,只根据<code>go.mod</code>下载依赖,这种模式称作<code>module-aware</code>模式，这种模式下，<code>GOPATH</code>不再在<code>build</code>时扮演导入的角色，但是尽管如此，它还是承担着存储下载依赖包的角色。它会将依赖包放在<code>GOPATH/pkg/mod</code>目录下。
</li>
<li class="md-list-item">
off：关闭模块支持，使用 GOPATH 和 vendor 目录作为依赖管理方式。可以通过设置环境变量 GO111MODULE 或者在项目目录中创建 go.mod 文件来配置 GO111MODULE。
<code>GO111MODULE=off</code>: 禁用 <code>go module</code>，编译时会在<code>vendor</code>目录下和<code>GOPATH</code>目录中查找依赖包。也把这种模式叫<code>GOPATH</code>模式
</li>
</ol>
<h2 class="md-end-block md-heading">3.GO ROOT 与 GO PATH</h2>
<h4 class="md-end-block md-p">　　GOPATH</h4>
　　GOPATH是Go语言的工作目录，它是一个环境变量，用于指定Go语言源代码、依赖库和可执行文件的存放位置。在Go语言中，所有的源代码都必须存放在GOPATH目录下的src子目录中，所有的依赖库和可执行文件则分别存放在GOPATH目录下的pkg和bin子目录中
　　GOPATH的作用是指定Go语言源代码、依赖库和可执行文件的存放位置，并且在编译项目时自动查找相应的文件。
               <img src="https://img2023.cnblogs.com/blog/1110857/202306/1110857-20230618004015117-505543065.png" alt="">
　　通过go env查看go环境相关的配置，可以看到 GO111MODULE 没有设置，默认为关闭off，项目的go依赖文件下载到 go path 目录中对应的src文件夹下：
                     <img src="https://img2023.cnblogs.com/blog/1110857/202306/1110857-20230618004102955-2079184759.png" alt="">
<h4>　　GOROOT</h4>
　　GOROOT是Go语言的安装目录，它是一个环境变量，用于指定Go语言的安装路径。在Go语言中，所有的标准库都存放在GOROOT目录下的src子目录中，所有的可执行文件则存放在GOROOT目录下的bin子目录中。
<div>
<h2 class="md-end-block md-heading md-focus">4.环境配置设置</h2>
　　Windows 下开启 GO111MODULE 的命令为：
<div class="cnblogs_code">
<pre>set GO111MODULE=on
set GO111MODULE=auto</pre>
</div>
　　go 1.3版本之后,可以通过以下命令修改<code>GO111MODULE</code>:
<div class="cnblogs_code">
<pre>go env -w GO111MODULE=on
go env -w GO111MODULE=auto</pre>
</div>
　　linux配置
<div class="cnblogs_code">
<pre># 开启模块支持
export GO111MODULE=on
# 关闭模块支持
export GO111MODULE=off</pre>
</div>
<h2 class="md-end-block md-heading md-focus">5.创建go.mod文件</h2>
　　在项目目录中执行以下命令会自动创建 go.mod 文件：
<div class="cnblogs_code">
<pre>go mod init <module-name></pre>
</div>
　　其中，module-name 是你的项目名称。管理依赖仓库：当 GO111MODULE 开启时，Go 语言会优先从 go.mod 文件中的模块信息中获取依赖库的版本信息，如果没有找到，则会去 GOPATH 和 vendor 目录下查找依赖库。使用 go get 命令或者直接修改 go.mod 文件来管理依赖库的版本信息。例如：
<div class="cnblogs_code">
<pre># 使用 go get 命令安装依赖库（会自动更新 go.mod 文件）
go get -u github.com/gin-gonic/gin
# 直接修改 go.mod 文件
require (
github.com/gin-gonic/gin v1.6.3
)</pre>
</div>
　　可以使用以下命令来更新依赖库：
<div class="cnblogs_code">
<pre>go mod tidy# 移除不需要的依赖库
go mod vendor# 将依赖库复制到 vendor 目录下
go mod download# 下载依赖库</pre>
</div>
<h2 class="md-end-block md-heading md-focus">6.go.mod 文件说明</h2>
　　如在mygo项目的目录下，输入go mod init mygo 指令即可在mygo下创建go.mod文件
　　在mygo的go.mod中设置自定义包mpb的信息，mygo的go.mod代码如下
<div class="cnblogs_code">
<pre>module mygo
go 1.18
require (
mpb v0.0.0
)
replace mpb => ./mpb</pre>
</div>
　　go.mod的代码说明如下：
　　　　1）module mygo代表当前go.mod文件隶属于文件夹mygo。
　　　　2）go 1.18代表当前Go语言的版本信息。
　　　　3）require代表需要调用第三方包或自定义包，小括号里面一行代码代表一个包信息。
　　　　4）mpb v0.0.0代表包的信息，mpb是包名，v0.0.0是当前包的版本信息。
　　　　5）replace为require的包指定新的路径地址，常用于本地自定义包或第三方包的路径迁移，例如mpb => ./mpb代表自定义包mpb为当前路径的文件夹mpb。
 
</div>
　　 
来源：https://www.cnblogs.com/zjdxr-up/p/17488589.html

頁: [1]

琼殿技术论坛's Archiver

GO 项目依赖管理：go module总结