Go mod踩坑记录，经验分享！

2023-11-27 05:57:55

在现代软件开发中，依赖管理是一个必不可少的环节。Go mod作为Go语言的官方依赖管理工具，为开发者提供了便捷的依赖管理方式。然而，在实际使用过程中，难免会遇到各种各样的坑。本文将分享我在使用Go mod进行依赖包管理时遇到的几个坑，并提供相应的解决方案。

坑一：配置本地仓库时，需要在Go mod配置文件中显式声明

在使用Go mod管理依赖包时，我们经常需要使用本地仓库。例如，当我们需要使用某个项目中的某个模块时，我们可以将该项目克隆到本地，然后在Go mod配置文件中添加一行，指定该模块的路径。例如：

module github.com/my-username/my-project

require (
    github.com/other-username/other-project v1.2.3
    github.com/my-username/local-project v0.0.1 // 本地仓库
)

然而，需要注意的是，在Go mod配置文件中添加本地仓库的路径时，我们需要在路径前加上file://前缀。否则，Go mod将会尝试从远程仓库下载该模块，而不是从本地仓库。例如：

module github.com/my-username/my-project

require (
    github.com/other-username/other-project v1.2.3
    file:///Users/my-username/Projects/local-project v0.0.1 // 本地仓库
)

坑二：配置私有仓库时，需要使用SSH密钥

在使用Go mod管理依赖包时，我们经常需要使用私有仓库。例如，当我们需要使用某个公司内部的模块时，我们可能会将其托管在私有仓库中。此时，我们需要在Go mod配置文件中添加一行，指定该模块的路径和访问凭证。例如：

module github.com/my-username/my-project

require (
    github.com/other-username/other-project v1.2.3
    github.com/my-company/private-project v0.0.1 // 私有仓库
)

然而，需要注意的是，在Go mod配置文件中添加私有仓库的路径时，我们需要使用SSH密钥进行身份验证。否则，Go mod将会无法访问私有仓库。例如：

module github.com/my-username/my-project

require (
    github.com/other-username/other-project v1.2.3
    github.com/my-company/private-project v0.0.1 // 私有仓库
)

env GO111MODULE=on
go env -w GOPRIVATE=github.com/my-company/*
go env -w GOPROXY=https://goproxy.io

坑三：使用Go mod解决依赖冲突

在使用Go mod管理依赖包时，我们经常会遇到依赖冲突的问题。例如，当我们需要使用两个不同的模块时，这两个模块可能依赖于不同的版本同一个库。此时，Go mod将会尝试解决依赖冲突。例如：

module github.com/my-username/my-project

require (
    github.com/other-username/other-project v1.2.3 // 依赖于库A v1.0.0
    github.com/my-company/private-project v0.0.1 // 依赖于库A v2.0.0
)