Go 中创建模块需用 go mod init 指定模块路径（如 github.com/username/project），生成 go.mod 和 go.sum 文件，依赖由工具链自动管理，推荐 cmd/internal/pkg 等目录结构。
在 Go 中创建模块，核心是使用 go mod 命令初始化项目并管理依赖。从 Go 1.11 起，模块（module）成为官方推荐的依赖管理机制，取代了旧的 GOPATH 工作模式。只要你的项目有明确的导入路径（即 module path），就能用 go mod init 快速启动。
明确模块路径再执行 go mod init
go mod init 的关键参数是模块路径（module path），它通常对应项目的远程仓库地址（如 github.com/username/project），但也可以是任意合法的标识符（例如本地开发时可用 myapp）。这个路径会写入 go.mod 文件首行，并影响后续所有包的导入语句。
- 在项目根目录运行：
go mod init github.com/yourname/myproject - 如果尚未关联远程仓库，可先用占位路径（如
go mod init myproject），后续再通过go mod edit -module new/path修改 - 模块路径中避免使用下划线（
_）或大写字母，推荐全小写、短横线分隔的风格
初始化后自动生成 go.mod 和 go.sum
执行 go mod init 后，Go 会生成两个关键文件：
-
go.mod：声明模块路径、Go 版本、直接依赖及其版本（格式为require example.com/v2 v2.0.0） -
go.sum：记录每个依赖模块的加密校验和，用于验证下载内容完整性，不应手动修改 - 两者都应纳入版本控制（Git）；若项目无外部依赖，
go.mod中可能只有module和go两行
添加依赖时自动更新 go.mod
无需手动编辑 go.mod，Go 工具 链会在你首次导入并使用某个包时自动下载并记录依赖：
立即学习“go 语言免费学习笔记（深入）”；
- 在代码中写
import "golang.org/x/sync/errgroup"，然后运行go build或go run *.go - Go 会自动下载该模块最新兼容版本，并在
go.mod中添加require行 - 也可显式触发：
go get golang.org/x/sync@v0.7.0（支持版本号、分支名、commit hash）
保持模块结构清晰的常用习惯
模块本身不强制目录结构，但合理组织能提升可维护性：
-
cmd/存放可执行命令（每个子目录一个 main 包） -
internal/存放仅本模块使用的私有包（Go 会阻止外部模块导入） -
pkg/存放可被其他项目复用的公共库包 -
api/或proto/存放接口定义或协议文件 - 主模块的
main.go通常放在项目根目录或cmd/xxx/下
