Go Academy · 课时

使用 go mod 管理 Go 模块

初始化模块、go.mod 与 go.sum

使用 go mod 管理 Go 模块 是 CoddyKit 上的免费 Go Academy 课时。这是第 2 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 Go Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Go Academy 课程共包含 4 节课。

什么是 Go 模块

模块是由多个 Go 包组成的集合，其根目录中包含一个 go.mod 文件。模块是 Go 中代码分发和版本管理的基本单位：

// go.mod — created with: go mod init github.com/myuser/myapp
module github.com/myuser/myapp

go 1.21

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

go mod init

使用 go mod init 初始化一个新模块：

# In project directory:
go mod init github.com/myuser/myapp

# This creates go.mod:
# module github.com/myuser/myapp
# go 1.21

# The module path is the canonical import path prefix
# for all packages in this module

go.sum——完整性验证

go.sum 记录所有依赖项的加密校验和。请勿手动编辑它——Go 命令会维护此文件：

# go.sum example entries:
github.com/gin-gonic/gin v1.9.1 h1:4idEAncQnU5cB7BeOkPtxjfCSye0AAm1R0RVIqJ+Jmg=
github.com/gin-gonic/gin v1.9.1/go.mod h1:hPrL7YrpYKXt5YId3A/Tnip5kqbEAP+KLuI3SUcPTeU=

# Commit go.sum to version control — it ensures reproducible builds

go get——添加依赖项

使用 go get 添加或更新依赖项。它会同时更新 go.mod 和 go.sum：

# Add latest version
go get github.com/pkg/errors

# Add specific version
go get github.com/pkg/errors@v0.9.1

# Upgrade to latest patch release
go get -u=patch github.com/pkg/errors

# Remove unused dependency from go.mod
go mod tidy

go mod tidy

go mod tidy 会向 go.mod 和 go.sum 添加缺少的依赖项，并移除未使用的依赖项。编辑导入声明后请运行它：

# After adding/removing imports:
go mod tidy

# What it does:
# 1. Adds any missing module requirements
# 2. Removes requirements for packages no longer imported
# 3. Updates go.sum with needed checksums
# 4. Best practice: run before committing

使用 Semver 进行模块版本管理

Go 模块使用语义化版本。主版本号 >= 2 时必须添加路径后缀：

// v1: github.com/pkg/errors
import "github.com/pkg/errors"

// v2+: module path includes major version
import "github.com/foo/bar/v2"
import "github.com/foo/bar/v3"

// go.mod:
// require github.com/foo/bar/v2 v2.3.1

go mod vendor

供应商模式会将所有依赖项复制到本地 vendor/ 目录，以便进行离线构建：

# Copy deps to vendor/
go mod vendor

# Build using vendor/
go build -mod=vendor ./...

# Useful for:
# - Air-gapped environments
# - Reproducible CI builds without network
# - Code review of dependencies

replace 指令

go.mod 中的 replace 指令会用本地路径或其他版本替代某个模块——这对本地开发很有用：

module github.com/myapp

go 1.21

require github.com/mylib v1.0.0

// Use local fork during development:
replace github.com/mylib => ../mylib

// Replace with a specific version:
// replace github.com/mylib v1.0.0 => github.com/myfork v1.0.0

go env GOPATH 和 GOMODCACHE

Go 模块的关键环境变量：

# Module cache location (default: ~/go/pkg/mod)
go env GOMODCACHE

# Proxy for downloading modules (default: proxy.golang.org)
go env GOPROXY

# Sum database for checksum verification
go env GONOSUMCHECK

# Disable module proxy (use direct)
export GOPROXY=direct

go list 和 go mod graph

使用以下命令检查模块依赖关系：

# List all modules in the build
go list -m all

# Show module dependency graph
go mod graph

# Find which module provides a package
go list -m -json all | grep -A5 gin

# Check for available updates
go list -m -u all

快速检查

go mod tidy 的作用是什么？

回顾：Go 模块

模块的关键概念：

go mod init 会创建包含 go.mod 文件的模块
go.mod 列出模块名称、Go 版本和依赖项
go.sum 保存校验和——请将它提交到版本库
go get 添加或更新依赖项，go mod tidy 进行清理
使用 replace 管理本地开发分支
主版本号 v2+ 必须添加路径后缀

常见问题解答

「使用 go mod 管理 Go 模块」课时是免费的吗？

是的 — 「使用 go mod 管理 Go 模块」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Go Academy 课程的其余内容，请升级到 CoddyKit PRO。 Go Academy 课程共包含 4 节课。

「使用 go mod 管理 Go 模块」这节课中我会学到什么？

初始化模块、go.mod 与 go.sum 你通过在浏览器中直接运行的动手代码来练习 Go Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Go Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Go Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 2 节课，共 4 节。

「使用 go mod 管理 Go 模块」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Go Academy 课中编写并运行代码吗？

能。每节 Go Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 Go Academy