只需运行 go mod init example.com/myproject 即可初始化模块并生成 go.mod 文件;go.sum 文件在首次下载依赖时(如 go build、go get 或 go mod tidy)自动生成,用于校验依赖完整性。

在 Go 项目中初始化模块、生成 go.mod 和 go.sum 文件,只需一条命令即可完成,前提是已安装 Go(1.11+)并正确配置了环境。
使用 go mod init 初始化模块
进入你的项目根目录(即包含 main.go 或其他 Go 源文件的目录),运行:
go mod init example.com/myproject
其中 example.com/myproject 是你为该模块指定的模块路径(module path),通常建议使用可解析的域名加项目名,即使不托管在该域名下也无妨。它将作为依赖引用时的唯一标识。
立即学习“go语言免费学习笔记(深入)”;
执行后会生成 go.mod 文件,内容类似:
module example.com/myproject
go 1.22
go.sum 文件何时生成?
go.sum 不会在 go mod init 时立即生成,而是在首次下载并校验依赖时自动生成。常见触发方式有:
- 运行
go build或go run main.go(当代码中 import 了外部包时) - 显式执行
go get some/external/package - 运行
go mod tidy(推荐:自动添加缺失依赖、清理未使用依赖,并更新go.sum)
生成后,go.sum 会记录每个依赖模块的版本哈希值,用于后续校验完整性,防止依赖被篡改。
常见注意事项
- 模块路径应全局唯一;若项目将来要公开,建议与代码托管地址一致(如
github.com/username/repo) - 若当前目录已有
go.mod,再次运行go mod init会报错,需先删除或用-replace等方式调整 - 本地开发时可配合
go mod edit -replace替换为本地路径,方便调试未发布的模块 - 提交代码时,
go.mod和go.sum都应纳入版本控制
快速验证是否成功
执行以下命令检查模块状态:
go list -m — 查看当前模块名go list -m all — 列出所有依赖及其版本go mod verify — 校验 go.sum 中的哈希是否匹配实际下载内容










