go mod 是 Go 语言（Golang）的官方依赖管理工具，用于管理项目的模块（Module）和依赖关系。以下是 go mod 的核心用法和常见操作：
1. 初始化模块
在项目根目录下运行以下命令，初始化一个 Go 模块（生成 go.mod 文件）：
go mod init <module-name>
<module-name>通常是代码仓库的路径（如github.com/username/project）。- 示例：
go mod init github.com/yourname/demo
2. 自动处理依赖
运行以下命令会自动下载并添加项目所需的依赖到 go.mod，同时生成 go.sum（记录依赖的哈希校验）：
go mod tidy
3. 常用命令
| 命令 | 作用 |
|---|---|
go mod download |
下载依赖到本地缓存（默认在 $GOPATH/pkg/mod）。 |
go mod vendor |
将依赖复制到项目的 vendor 目录（适合离线环境）。 |
go list -m all |
查看当前项目的所有直接和间接依赖。 |
go mod graph |
打印模块依赖图。 |
go mod verify |
验证依赖的完整性（检查是否被篡改）。 |
4. go.mod 文件示例
module github.com/yourname/demo
go 1.21
require (
github.com/gin-gonic/gin v1.9.0
golang.org/x/sys v0.8.0
)
replace github.com/old/pkg => ./local/pkg // [关键]替换本地或自定义依赖
5. GOPROXY
Go Module 默认使用代理服务器下载依赖，国内可配置阿里云代理加速：
# 设置代理（国内推荐）
go env -w GOPROXY=https://mirrors.aliyun.com/goproxy/,direct
# [可选]关闭代理校验（私有仓库可能需要）
go env -w GOSUMDB=off
6. Vendor模式
如果希望将依赖打包到项目中（避免在线下载）：
go mod vendor # 生成vendor目录
go build -mod=vendor # 使用vendor构建
7. FAQ
(1) Git仓库拉取失败？
确保代码托管平台（如 GitHub/GitLab）支持 HTTPS，或配置 Git SSH：
git config --global url."git@github.com:".insteadOf "https://github.com/"
(2) Import私有库？
在 .gitconfig （或命令行）中配置私有库访问权限。
(3) Go版本不一致？
修改 go.mod中的版本号：
// go.mod的第一行指定了最低要求的Go版本。
// go version必须 >=这里指定的版本才能编译。
module example.com/mymodule
// [!code focus]
// +line directives can be used to specify the minimum required Go version.
// For example, this module requires at least Go version X.Y:
//
// go X.Y[+.Z]
//
// The '+' indicates that any patch release is acceptable.
//
// If you need to enforce a specific minor or patch version,
// use '>=', '<', etc., in a comment like this:
//
// // go >=X.Y.Z
//
// But note that the toolchain does not enforce these constraints;
// they are merely documentation for humans.
require (
...
)
如果需要更具体的场景解答，可以告诉我你的需求！
内容由零声教学AI助手提供，问题来源于学员提问
