Go包管理与依赖管理

Go模块系统（Module）是官方依赖管理方案，使用go.mod文件管理项目依赖。

go.mod文件结构

基本结构

module github.com/user/myproject

go 1.22

require (
    github.com/gin-gonic/gin v1.9.1
    golang.org/x/tools v0.15.0
)

require (
    github.com/other/lib v1.0.0 // indirect
)

文件说明

// module：模块路径（项目唯一标识）
// go：Go版本要求
// require：直接依赖
// require (indirect)：间接依赖
// replace：替换依赖源
// exclude：排除特定版本

go mod命令

常用命令

# 初始化模块
go mod init github.com/user/myproject

# 添加依赖
go get github.com/gin-gonic/gin@v1.9.1

# 整理依赖（添加缺失、删除多余）
go mod tidy

# 验证依赖
go mod verify

# 查看依赖图
go mod graph

# 下载依赖到本地缓存
go mod download

# 查看依赖信息
go list -m all

依赖版本管理

版本指定方式

# 指定版本
go get package@v1.2.3

# 最新版本
go get package@latest

# 特定分支
go get package@main

# 版本范围
go get package@>=v1.2.0

版本选择规则

最小版本选择（MVS）：
- 选择满足所有依赖要求的最低版本
- 确定性强，避免版本漂移
- 不自动升级到更高版本

示例：
A require B >= v1.2.0
C require B >= v1.3.0
最终选择 B v1.3.0（满足两者的最小版本）

go.sum文件

内容格式

github.com/gin-gonic/gin v1.9.1 h1:abc123...
github.com/gin-gonic/gin v1.9.1/go.mod h1:def456...

作用

- 记录依赖的加密哈希值
- 确保依赖完整性
- 防止依赖被篡改
- 验证下载依赖的正确性

go.sum不应删除，保证构建一致性。

replace替换依赖

本地开发替换

// go.mod
replace github.com/user/lib => ../lib

// 或指定版本替换
replace github.com/user/lib v1.0.0 => ../lib

替换不可用依赖

// 替换失效源
replace github.com/old/pkg => github.com/new/pkg v1.0.0

// 替换为fork版本
replace github.com/original => github.com/myfork v1.2.0

exclude排除版本

// 排除有问题的版本
exclude github.com/user/lib v1.2.0

私有仓库配置

GOPRIVATE设置

# 设置私有仓库不走公共代理
export GOPRIVATE=github.com/mycompany/*

# 或配置多个
export GOPRIVATE=github.com/mycompany/*,gitlab.myorg.com/*

Git配置

# 配置Git访问私有仓库
git config --global url."git@github.com:".insteadOf "https://github.com/"

# 或配置.netrc文件存储凭证

依赖管理流程

go.mod vs GOPATH对比

要点总结

• go.mod是依赖管理核心文件
• module声明模块路径
• require列出项目依赖
• go mod tidy整理依赖
• go.sum记录依赖哈希，保证完整性
• 最小版本选择确保版本确定
• replace替换依赖源或本地开发
• GOPRIVATE配置私有仓库
• Go模块比GOPATH更现代化