用途:帮助开发者搭建与整理 Go 项目结构,包括命令行工具、库、服务与单模块仓库的布局,以及多模块本地开发工作区。核心原则是按问题规模选择结构,小型脚本保持扁平,只有实际复杂度需要时才分层。
主要能力:
- 结构决策:新建项目时先确认软件架构偏好(整洁架构、六边形、DDD、扁平结构等),再确认依赖注入方式(手写构造函数注入,或 samber/do、google/wire、uber-go/dig+fx 等库,或不用)。这两项会级联影响后续每个文件的创建。
- 目录约定:main 包放在 cmd/ 下且逻辑最小,仅解析参数、装配依赖并调用 Run();业务逻辑放在 internal/(不对外暴露)或 pkg/(可被外部引用)。
- 命名:go.mod 模块路径必须与仓库 URL 一致,全小写,多词用连字符,如 github.com/jdoe/payment-processor;包名小写、单数并与目录名一致。
- 应用遵循 12-Factor:配置走环境变量、日志输出到 stdout、无状态进程、优雅关闭、后端服务作为附加资源、管理任务作为一次性命令(如 cmd/migrate/)。
- 测试:_test.go 与被测代码同目录,固定数据放 testdata/。
- 必备配置:根目录包含 Makefile、.gitignore、.golangci.yml。
- 多模块开发用 go.work 管理相关模块,通过 replace 指令处理本地依赖。
使用方式:按初始化清单执行,例如先运行 go version 检测版本,再运行 go mod init github.com/user/project-name,创建 cmd/{name}/main.go 入口,按需建立 internal/ 与 pkg/,单模块仓库执行 go work init 并添加模块,最后用 gofmt -s -w . 格式化,并在 .gitignore 中忽略 /vendor/ 与二进制文件。提问应通过环境提供的提问工具逐个进行,不要用纯文本方式。
适用场景:新建 Go 项目、将现有代码迁移到上述布局、本地多模块协同开发。
限制:技能自身说明未提供具体收费、价格或平台信息;部分细节指向同系列其他技能(依赖注入、设计模式、重构、Lint、CI、CLI、命名等)的文档,需另行查阅。