Go Modules是Golang 1.11+推荐的依赖管理方式，无需依赖GOPATH。首先确保Go版本不低于1.11，建议使用1.16+以获得默认模块支持；若为旧版本需执行go env -w GO111MODULE=on启用。国内用户应配置代理加速依赖下载，如go env -w GOPROXY=https://goproxy.cn,direct，必要时通过GOPRIVATE排除私有仓库。在任意目录下运行go mod init 初始化项目，生成go.mod文件。导入外部包后执行go build会自动下载依赖并更新go.mod和go.sum。常用命令包括：go mod tidy清理冗余依赖，go get安装指定版本包，go list -m all查看所有依赖，go mod download预下载依赖，go mod verify校验完整性。正确配置环境后，原生命令即可高效管理模块。
使用 Go Modules 进行模块管理是现代 Golang 开发的标准方式。从 Go 1.11 版本开始引入，Go Modules 让你可以脱离 $GOPATH 的限制进行项目依赖管理。下面介绍如何搭建支持 Go Modules 的环境并正确使用。
1. 确认 Go 版本并启用 Modules
要使用 Go Modules，首先确保安装的 Go 版本不低于 1.11。推荐使用 1.16 及以上版本以获得更好的兼容性和功能支持。
检查 Go 版本：go version
如果输出类似 go version go1.21.5 linux/amd64，说明已正确安装。
Go 1.16+ 默认启用 Modules 模式，无需额外设置。对于旧版本，建议手动开启：
go env -w GO111MODULE=on
这样会强制启用模块支持，即使项目不在 GOPATH 中也能正常工作。
2. 配置代理和下载源（国内用户特别需要）
由于网络问题，国内开发者访问官方模块站点（proxy.golang.org）可能较慢或失败。建议配置国内镜像代理。
设置 Go 模块代理：
go env -w GOPROXY=https://goproxy.cn,direct
你也可以使用其他镜像，如阿里云：
go env -w GOPROXY=https://mirrors.aliyun.com/goproxy/,direct
PROXY=https://mirrors.aliyun.com/goproxy/,directdirect 表示当代理无法响应时，尝试直接拉取源码。
若项目依赖私有仓库，可设置私有路径不走代理：
go env -w GOPRIVATE=git.company.com,github.com/yourname/private-repo
3. 创建新模块项目
在任意目录（不需要在 GOPATH 内）初始化一个新的 Go 模块项目：
mkdir myproject
cd myproject
go mod init myproject
执行后会生成 go.mod 文件，内容类似：
module myproject go 1.21
当你在代码中导入外部包并运行构建时，Go 会自动下载依赖并写入 go.mod 和 go.sum 文件。
例如，在 main.go 中导入：
import "github.com/gin-gonic/gin"
然后运行：
go build
Go 会自动下载 gin 框架及相关依赖，并更新 go.mod。
4. 常用模块命令
掌握以下常用命令有助于日常开发：
- go mod tidy：清理未使用的依赖，补全缺失的依赖
- go get github.com/pkg/errors@v0.9.1：拉取指定版本的包
- go list -m all：列出当前项目所有依赖模块
- go mod download：预下载所有依赖到本地缓存
- go mod verify：验证依赖的完整性
基本上就这些。只要版本够新、代理配好、项目初始化正确，Go Modules 使用起来非常顺畅。不需要复杂工具，原生命令即可完成大多数任务。
