必须用 cobra-cli init 初始化项目，它自动生成含正确初始化逻辑的 cmd/root.go、main.go 等骨架，避免 nil pointer 错误和 help 失效；加子命令必须用 cobra-cli add，use 字段仅用于展示和匹配，flag 和 args 必须在 init 中注册，补全脚本需手动加载。
直接用 cobra-cli init 初始化项目，比手写 rootCmd 和 Execute() 快得多，也更少出错。
初始化项目必须用 cobra-cli init，别自己 new rootCmd
很多人卡在第一步：手动创建 main.go，复制粘贴 cobra.Command{} 结构，结果 rootCmd.Execute() 报 nil pointer 或 help 不生效。根本原因是没初始化内部状态字段（比如 command.parent、command.root），而 cobra-cli init 生成的 cmd/root.go 已经做了这些。
-
cobra-cli init会生成完整骨架：cmd/root.go（含全局 flag 注册）、main.go（含错误处理和 exit code）、cmd/version.go等 - 它自动调用
rootCmd.AddCommand()挂载子命令，避免你漏掉add步骤 - 生成的
init()函数里已预埋pflag.Parse()和viper.AutomaticEnv()钩子（如果你后续集成 viper） - 别用
go get github.com/spf13/cobra后自己 new struct —— 这样缺了命令树遍历逻辑，--help子命令分组、级联 flag 都不工作
加子命令必须用 cobra-cli add，别改 Use 字段硬凑
看到别人代码里把 Use: "serve" 改成 "serve --port 8080" 来“模拟 flag”，这是典型误区。Cobra 的 Use 只用于 help 文本展示和拼写纠错匹配，实际参数解析靠 Flags() 和 Args()。
-
cobra-cli add serve会在cmd/下生成serve.go，里面已有serveCmd.Flags().IntVarP(&port, "port", "p", 8080, "server port")模板 - 想让
myapp serve example.com中的example.com被校验？用Args: cobra.ExactArgs(1)，不是塞进Use - 如果手写命令并漏掉
rootCmd.AddCommand(serveCmd)，运行myapp serve会提示unknown command "serve"，但--help里却看不到它 —— 因为没注册进命令树 -
Use字段值必须是纯命令名（如"serve"），不能带空格或 flag；否则cobra.BashCompCustom补全会失效
补全脚本要手动安装，Cobra 不会自动 source
运行 myapp <tab></tab> 没反应？不是 Cobra 坏了，是你没把生成的脚本加载进 shell 环境。
- 先生成：
myapp completion bash > myapp.bash（注意不是rootCmd.GenBashCompletionFile()—— 那是旧 API，v1.7+ 推荐用内置completion子命令） - 再加载：
source ./myapp.bash，或者拷到系统路径：sudo cp myapp.bash /usr/local/share/bash-completion/completions/myapp - Zsh 用户额外执行：
autoload -U compinit && compinit，否则compdef不生效 - Fish 用户必须用
myapp completion fish > ~/.config/fish/completions/myapp.fish，bash 脚本在 fish 里完全无效
Flag 和 Args 的绑定时机很关键，别在 Run 里解析
常见错误：在 Run 函数里用 flag.String("port", ...) 手动解析 —— 这会绕过 Cobra 的 flag 树机制，导致 --help 不显示该 flag，且子命令无法继承 persistent flag。
- 所有 flag 必须在
init()或func init() { ... }里注册，例如：rootCmd.PersistentFlags().StringVar(&cfgFile, "config", "", "config file") - 局部 flag（只对某子命令生效）用
serveCmd.Flags().BoolVarP(&debug, "debug", "d", false, "enable debug log") - Args 校验函数（如
cobra.MinimumNArgs(2)）必须赋给Args字段，不能在Run里用len(args)判断 —— 否则错误信息是通用的accepts 2 arg(s), received 1，而不是你自定义的提示 - 如果 flag 值依赖 runtime（比如从文件读配置），别在
init()里直接赋值，用func() string { return readConfig() }包一层，延迟求值
最易被忽略的是命令注册顺序和 flag 绑定时机：Cobra 在 Execute() 前就完成了整个命令树构建和 flag 解析，Run 函数只是最后执行动作的钩子，不是解析入口。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
