单仓模式用gf init web-service生成独立服务,含go.mod和main.go;多仓模式需先-m建根仓再-a加子服务,仅根目录有go.mod,各app/*/cmd/main.go为入口。

你要为新微服务项目选 GoFrame 的工程初始化模式,但面对 gf init 后的三种选项——不带参数、-m、-a——拿不准该用单仓还是多仓,更不清楚它们生成的目录结构、go.mod 位置和入口文件分布到底差在哪,一选错后续加服务、切环境、协同开发就卡壳。
单仓模式(普通单 repo)怎么初始化与识别
直接执行 gf init web-service,不加任何参数。
命令执行后会在当前目录下创建 【web-service/】 子目录,并在其中生成完整的可运行项目:根目录含 go.mod、main.go、config/、app/ 等标准结构;main.go 是唯一入口,调用 g.Server().Run() 启动服务。
这种结构天然对应一个独立部署单元——打包成单个二进制,配置一套环境变量,日志输出一个路径,运维视角就是“一个服务一个进程”。
多仓模式(大仓根 + 子服务)的构建路径
第一步:先建大仓根目录,执行 gf init my-platform -m。
第二步:进入该目录 cd my-platform,再执行 gf init app/user -a。
第三步:重复第二步,添加 app/order、app/payment 等子服务。
最终结构是:顶层 my-platform/ 下有 go.mod 但没有 main.go;每个 app/*/ 子目录内含完整服务代码、cmd/main.go 入口、独立的 config/ 和 internal/,但无自己的 go.mod ——全部复用顶层模块定义。
这一步不能颠倒:必须先 -m 再 -a,否则 -a 会报错找不到大仓上下文。你要是跳过第一步直接 gf init app/user -a,命令会失败并提示“not in a mono-repo root”。
单仓与多仓的核心差异对比
方法一:看 go.mod 位置
单仓:每个服务目录下都有自己的 go.mod,模块路径形如 github.com/your/web-service;
多仓:仅顶层目录有 go.mod,模块路径是 github.com/your/my-platform,所有子服务都以 my-platform/app/user 这类相对导入路径引用。
方法二:看启动入口分布
单仓:只有一个 main.go,位于服务根目录;
多仓:每个 app/*/ 下都有 cmd/main.go,可单独 go run cmd/main.go 启动该子服务,也可统一用 gf run app/user 调度。
方法三:看依赖管理粒度
单仓模式下,各服务升级 GoFrame 版本需各自操作 go get github.com/gogf/gf/v2;
多仓模式下,只需在顶层 go.mod 中统一升级一次,所有子服务自动继承——这是它对中大型团队最实在的价值。

















