Cobra 无原生分组机制，需通过目录结构、独立命令实例及 AddCommand 模拟；dbCmd 等“组”须为带 Use/Short 的 *cobra.Command，子命令必须调用 dbCmd.AddCommand() 注册，而非直挂 rootCmd。
子命令分组不是 Cobra 原生概念，得靠目录+结构体+AddCommand 模拟
Cobra 本身没有 Group 类型或 AddGroup() 方法。所谓“分组”，实际是开发者用文件目录、命令树层级和命名约定人为组织的逻辑单元。比如把所有数据库相关命令放进 cmd/db/ 目录，每个子命令定义为独立 *cobra.Command 实例，再统一挂到 dbCmd 下——这个 dbCmd 就是你的“组”。
常见错误是试图在单个 Run 函数里用 args[0] 判断分支，结果 --help 不显示子命令列表，db --help 只输出根帮助，完全失去分组语义。
- 每个“组”应是一个带
Use和Short的独立*cobra.Command（如dbCmd := &cobra.Command{Use: "db", Short: "Database operations"}） - 组内子命令（如
db migrate、db seed）必须调用dbCmd.AddCommand(migrateCmd)，而不是rootCmd.AddCommand(migrateCmd) -
dbCmd自身的Run留空或只打印简短提示（如"Run 'db [command]' for details"），避免干扰子命令执行流
子命令注册顺序不影响执行，但影响 help 输出层级
你调用 rootCmd.AddCommand(dbCmd) 和 rootCmd.AddCommand(serverCmd) 的先后顺序，不会改变 mycli db migrate 或 mycli server start 的行为，但会决定 mycli --help 中命令列表的排列顺序。Cobra 默认按注册顺序展示，且不自动分组标题。
想让 help 更清晰，得手动干预：
立即学习“go语言免费学习笔记（深入）”；
- 在
rootCmd.SetHelpTemplate()里自定义模板，用{{range .Commands}}遍历时加条件判断（如根据.Name前缀归类） - 给每个组命令的
Short字段开头加符号，如"? Database operations"或"? Server management"，靠视觉分隔 - 避免依赖隐式分组；用户不会从 help 文本里自动理解 “db” 和 “server” 是并列组——你得在文档或 README 里明确说明
跨组共享 flag 必须用 PersistentFlags，且只能向上继承
如果 db migrate 和 server start 都需要 --env=prod，不能分别在两个子命令里重复声明 StringFlag。正确做法是在它们共同的父级（通常是 rootCmd）上调用 rootCmd.PersistentFlags().String("env", "dev", "environment")。
注意作用域限制：
-
PersistentFlags向下透传：子命令能读，孙子命令也能读 -
LocalFlags仅限当前命令：在dbCmd.Flags()定义的 flag，db migrate拿不到 - 别在子命令的
Run里直接访问rootCmd.Flag("env").Value，应该用cmd.Flag("env").Value（cmd是当前执行的命令实例） - 如果某个 flag 只被部分子命令需要（如
--dry-run仅用于migrate），就只能在migrateCmd.Flags()里声明，无法“按需分组”
拆分到独立文件时，init() 或变量声明时机容易出错
把 dbCmd 放进 cmd/db/root.go，migrateCmd 放进 cmd/db/migrate.go，看似模块化，但极易因初始化顺序失败：
- 如果
migrate.go里只声明了var migrateCmd = &cobra.Command{...}，但没在任何地方调用dbCmd.AddCommand(migrateCmd)，该子命令永远不会出现在命令树中 - 不要依赖
init()函数自动注册；不同文件的init()执行顺序不可控，可能导致dbCmd还没初始化完，migrateCmd就尝试往它上面挂载 - 推荐显式注册：在
cmd/root.go的func init()里集中调用所有AddCommand，或在main()开头手动构建整棵树 - 验证是否成功：运行
go run main.go --help，检查输出中是否有你期望的子命令名；再运行go run main.go db --help，确认子命令列表完整
真正麻烦的不是写代码，而是当 mycli db migrate --help 报错说 unknown command "migrate" for "db" 时，你得一层层查是不是漏了 AddCommand、是不是 Use 拼错了、或者 RunE 是 nil 导致 Cobra 静默跳过注册。
