Go Modules是Golang 1.11版本引入、1.14版本正式成为默认依赖管理方案的官方工具，它允许项目脱离GOPATH目录创建，通过go.mod文件记录项目依赖的模块及版本信息，go.sum文件记录依赖的哈希校验值，保证依赖的一致性和安全性。
初始化Go Modules项目
首先确保本地Golang版本不低于1.11，且环境变量中GO111MODULE设置为on（Golang 1.14及以上版本默认开启）。在项目根目录执行以下命令初始化模块：
# 模块路径一般为项目的仓库地址，比如github.com/user/project go mod init github.com/yourname/yourproject
执行后会生成go.mod文件，初始内容如下：
module github.com/yourname/yourproject go 1.20
添加项目依赖
当项目中引入外部包时，Go Modules会自动处理依赖的下载和版本记录。比如在代码中引入gin框架：
package main
import (
"github.com/gin-gonic/gin" // 引入gin依赖
"net/http"
)
func main() {
r := gin.Default()
r.GET("/", func(c *gin.Context) {
c.JSON(http.StatusOK, gin.H{
"message": "hello world",
})
})
r.Run(":8080")
}
保存代码后执行go mod tidy命令，Go会自动下载gin及其所有间接依赖，同时更新go.mod和go.sum文件：
go mod tidy
此时go.mod会新增依赖记录：
module github.com/yourname/yourproject go 1.20 require github.com/gin-gonic/gin v1.9.1
管理依赖版本
查看依赖列表
执行以下命令可以查看当前项目的所有依赖及版本：
go list -m all
升级依赖版本
如果需要升级某个依赖到最新版本，执行：
# 升级gin到最新版本 go get github.com/gin-gonic/gin@latest
如果需要升级到指定版本，直接指定版本号即可：
# 升级gin到v1.8.0版本 go get github.com/gin-gonic/gin@v1.8.0
移除无用依赖
当代码中不再使用某个依赖时，执行go mod tidy会自动移除go.mod中对应的依赖记录，同时清理go.sum中无用的校验信息。
go.mod文件结构说明
go.mod文件主要包含以下几个部分：
- module：声明当前模块的导入路径
- go：声明项目使用的Golang版本
- require：声明项目直接依赖的模块及版本
- exclude：声明排除的指定模块版本
- replace：声明替换依赖模块的导入路径，常用于本地调试或替换私有仓库依赖
比如需要把gin替换为本地修改的版本，可以添加replace指令：
replace github.com/gin-gonic/gin => ../local-gin
依赖缓存机制
Go Modules下载的依赖会缓存到$GOPATH/pkg/mod目录下，下次其他项目使用相同版本的依赖时可以直接复用，不需要重复下载。如果需要清理缓存，可以执行：
go clean -modcache
常见问题处理
如果遇到依赖下载慢的问题，可以配置国内代理：
# 配置七牛云代理 go env -w GOPROXY=https://goproxy.cn,direct
如果项目是私有仓库，需要设置不校验HTTPS并跳过代理：
go env -w GOPRIVATE=github.com/yourname/* go env -w GOINSECURE=github.com/yourname/*
Go_ModulesGolang依赖管理go_mod修改时间：2026-07-06 14:24:16