FAQ: Development

FAQ: 开发环境

Q1: 当前目录结构说明:

• https://github.com/better-go/cookiecutter-go#generate-project-folder-structure
• 参考 cookiecutter-go 生成的目录结构解释.
• 公共基础服务集合:

zeromall/app/basic/

• 业务服务集合:

zeromall/app/biz/

Q2: 新增微服务, 目录存放位置?

• 用 goctl 生成api、rpc服务, 代码目录存放?
• zeromall 当前目录是基于: https://github.com/better-go/cookiecutter-go 这个脚手架创建的.
• 未使用 goctl, 部分原因是: 需要对工程目录, 做更多的定制化工作, goctl 不够.
• 言归正传: 新增子服务, 请放在: zeromall/app/biz/ 目录下.
  • zeromall/app/biz/xxx-micro-service-name-here
  • https://github.com/zeromicro/zeromall/blob/main/app/biz/bill/cmd/main.go

Q3: 同时使用 goctl 和 cookiecutter-go 两个工具, 创建微服务, 会不会混乱?

• 不会混乱, 请先写起来, 随便用什么目录结构, 不 care, 也不重要.
• 重要的是输出!持续有效输出!
• 根据个人使用偏好, 自由选择脚手架, 但是请统一在 zeromall/app/biz/下创建子服务, 唯一要求.
• 微服务, 原则上, 每个子服务下, 是独立单元. 跟其他服务, 不冲突.
• mono repo, 只是把很多业务, 放在一个 repo 下, 而已.
• 谁更好, 这个没有定论. 实践出真知.
• 不要纠结用哪个, 先把业务代码写好, 写出来, 再说. 后续无非是重构统一结构而已.
• 很多纠结该用哪个脚手架的人, 一行代码, 也没有写. 这没有意义.
• 代码写好, 一个个子服务, 搭积木. 聚沙成塔.
• 少说, 多做. 不做事的人, 没有发言权.

Q4: 开发方式?

• PR 方式.
• main 分支: 稳定分支
• dev 分支: 开发分支.
• fork 后, 本地创建 dev 分支, 然后提交 PR.
• 先合并到 dev 分支, 稳定后, 合并到 main 分支.