Go Modules - Go 包管理完全指南 #

入门阶段
├── Go Modules 简介 ──────── 了解基本概念
├── 基础使用 ─────────────── 掌握基本操作
└── 常用命令 ─────────────── 熟悉命令行

进阶阶段
├── 依赖管理 ─────────────── 理解依赖机制
├── 版本管理 ─────────────── 掌握版本控制
└── 高级特性 ─────────────── 使用高级功能

实战阶段
├── 最佳实践 ─────────────── 应用实战经验
└── 常见问题 ─────────────── 解决实际问题

# 1. 创建项目
mkdir myproject && cd myproject

# 2. 初始化模块
go mod init myproject

# 3. 创建 main.go
cat > main.go << 'EOF'
package main

import "github.com/gin-gonic/gin"

func main() {
    r := gin.Default()
    r.GET("/", func(c *gin.Context) {
        c.JSON(200, gin.H{"message": "Hello, Go Modules!"})
    })
    r.Run(":8080")
}
EOF

# 4. 运行（自动下载依赖）
go run main.go

# 模块管理
go mod init myproject      # 初始化模块
go mod tidy                # 整理依赖
go mod download            # 下载依赖
go mod verify              # 验证依赖

# 依赖管理
go get pkg@version         # 添加依赖
go get -u pkg              # 更新依赖
go list -m all             # 查看依赖

# 环境配置
go env GOPROXY             # 查看代理
go env -w GOPROXY=https://goproxy.cn,direct  # 设置代理

module github.com/myuser/myproject  // 模块路径

go 1.21  // Go 版本

require (
    github.com/gin-gonic/gin v1.9.1           // 直接依赖
    golang.org/x/text v0.14.0                 // 直接依赖
)

require (
    github.com/go-playground/validator v10.15.0 // indirect
)

vMAJOR.MINOR.PATCH

MAJOR - 不兼容的 API 变更
MINOR - 向后兼容的功能新增
PATCH - 向后兼容的问题修复

Go 选择满足所有依赖要求的最低版本

示例：
├── A 需要 pkg v1.2.0
├── B 需要 pkg v1.3.0
└── C 需要 pkg v1.1.0

选择结果：pkg v1.3.0

mkdir myproject && cd myproject
go mod init github.com/myuser/myproject
go get github.com/gin-gonic/gin@latest
go mod tidy

# 方式一：直接 get
go get github.com/gin-gonic/gin@v1.9.1

# 方式二：代码导入后 tidy
# 在代码中 import "github.com/gin-gonic/gin"
go mod tidy

# 更新单个依赖
go get github.com/gin-gonic/gin@latest

# 更新所有补丁版本
go get -u=patch

# 整理依赖
go mod tidy

# 配置私有模块
go env -w GOPRIVATE=github.com/mycompany/*

# 配置 Git SSH
git config --global url."git@github.com:".insteadOf "https://github.com/"

# 使用私有模块
go get github.com/mycompany/mylib@latest

# 配置代理
go env -w GOPROXY=https://goproxy.cn,direct

# 配置私有模块（如有）
go env -w GOPRIVATE=github.com/mycompany/*

# 启用模块模式
go env -w GO111MODULE=on

# 配置企业代理
go env -w GOPROXY=http://proxy.company.com,direct

# 配置私有模块
go env -w GOPRIVATE=gitlab.company.com/*

# 跳过私有模块校验
go env -w GONOSUMDB=gitlab.company.com/*

go list -m all

go get -u
go mod tidy

go clean -modcache

go mod vendor
go build -mod=vendor

# 查看依赖图
go mod graph | grep problematic

# 使用 replace
go mod edit -replace=old/pkg=new/pkg@v1.0.0