Go模块初始化方法及go.mod生成教程

只需运行 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 源文件的目录），运行：

其中 example.com/myproject 是你为该模块指定的模块路径（module path），通常建议使用可解析的域名加项目名，即使不托管在该域名下也无妨。它将作为依赖引用时的唯一标识。

执行后会生成 go.mod 文件，内容类似：

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 都应纳入版本控制

快速验证是否成功

执行以下命令检查模块状态：