使用go Modules初始化项目需先创建目录并执行go mod init,生成go.mod文件后编写代码,Go会自动下载依赖并更新go.mod和go.sum,常用命令包括go mod tidy、go list、go get等。

使用 Go Modules(go mod)初始化项目是现代 golang 开发的标准方式。它能帮助你管理依赖版本,无需将项目放在 GOPATH 目录下。下面详细介绍如何用 go mod 初始化一个 Golang 项目。
创建项目目录
打开终端,选择你喜欢的路径创建项目文件夹:
注意:项目名称建议使用小写字母、数字或短横线,避免空格和特殊字符。
– 新建目录:mkdir myproject
– 进入目录:cd myproject
运行 go mod init
在项目根目录执行以下命令来初始化模块:
go mod init 模块名
立即学习“go语言免费学习笔记(深入)”;
模块名通常是项目的导入路径,比如你的项目托管在 gitHub 上,可以写成:
go mod init github.com/yourname/myproject
如果你只是本地练习,也可以简写为:
go mod init myproject
执行成功后,会生成一个 go.mod 文件,内容类似:
module github.com/yourname/myproject <p>go 1.21</p>
编写代码并自动管理依赖
创建一个主程序文件 main.go:
package main <p>import ( "fmt" "rsc.io/quote" // 示例第三方包 )</p><p>func main() { fmt.Println(quote.Hello()) }</p>
保存后,在项目根目录运行:
go run main.go
这时 go 工具会自动分析 import 的外部包,并下载所需依赖,同时更新两个文件:
- go.mod:记录项目模块名和依赖项
- go.sum:记录依赖模块的哈希值,用于校验完整性
常用 go mod 命令补充
开发过程中可能用到的其他命令:
-
go mod tidy:清理未使用的依赖,补全缺失的依赖 -
go list -m all:列出当前项目所有依赖模块 -
go get 包名:手动添加或升级某个依赖 -
go mod download:预下载所有依赖到本地缓存 -
go mod vendor:导出依赖到 vendor 目录(可选)
基本上就这些。通过 go mod 初始化项目非常简单,只需几步就能搭建好现代化的 Go 项目结构,方便后续开发与协作。只要记得在项目根目录执行 go mod init,之后依赖会由 Go 自动管理。不复杂但容易忽略细节,比如模块命名规范和网络环境。


