flag适合单命令、无子命令、参数少、不需自动文档或补全的工具；cobra适合需子命令、自动帮助、参数校验与补全的复杂CLI，虽引入依赖但显著提升可维护性与扩展性。
直接用 flag 就能跑通简单需求，但一旦要加子命令（比如 go-fly server、go-fly install）、自动帮助页、参数校验或补全，flag 就得自己堆逻辑，容易出错且维护成本高；cobra 是为这类场景设计的，开箱即用，但引入了额外依赖和目录结构约定。
什么时候该用 flag 而不是 cobra
flag 适合单命令、无子命令、参数少、不需自动文档或补全的工具。比如一个只做「读配置 + 打印结果」的脚本，几行就能写完：
var port = flag.Int("port", 8080, "server port")
var debug = flag.Bool("debug", false, "enable debug log")
flag.Parse()
fmt.Printf("Starting on port %d, debug=%t\n", *port, *debug)
常见踩坑点：
-
flag.Parse()必须在所有flag.XxxVar或flag.Xxx()调用之后、首次访问参数值之前执行，否则取到的是零值 - 短选项（如
-p）需手动注册，flag不支持自动生成，flag.String("p", ...)和flag.String("port", ...)是两个独立参数 - 位置参数（如
./app file1.txt file2.txt）只能通过flag.Args()拿，无法绑定到变量，也不能设默认值或校验
cobra.Command 的初始化顺序不能乱
cobra 把命令组织成树，根命令必须先定义 Use、Run，再通过 AddCommand 注册子命令，且 init() 中的注册必须早于 Execute() 调用。比如 go-fly 的 root.go 里：
立即学习“go语言免费学习笔记（深入）”；
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
func init() {
rootCmd.AddCommand(versionCmd) // 必须在这里注册
rootCmd.AddCommand(serverCmd)
rootCmd.AddCommand(installCmd)
}
容易忽略的细节：
- 每个子命令（如
serverCmd）也得有自己的Use字段，比如"server [flags]"，否则cobra不知道怎么拼帮助信息 -
Args字段用于校验参数个数，比如cobra.ExactArgs(1)表示必须传且仅传 1 个位置参数，漏写会导致运行时才报错，而不是启动时提示用法 -
Run函数签名是func(*cobra.Command, []string)，第二个参数是位置参数，不是flag.Args()—— 它已经由cobra剥离并传入，别混用
flag 和 cobra 的参数绑定方式差异
flag 绑定靠指针，cobra 靠 BindPFlag 或直接在 Run 里调用 cmd.Flags().GetInt()。例如，想让 server 子命令支持 --port：
// cobra 方式：先声明 flag，再绑定到子命令
serverCmd.Flags().IntP("port", "p", 8080, "server port")
// 然后在 Run 里读
port, _ := serverCmd.Flags().GetInt("port")
关键区别：
-
flag的变量生命周期由用户管理（比如定义全局var port int），cobra的 flag 生命周期绑定在Command实例上，不同子命令可有同名 flag 且互不干扰 -
cobra支持PersistentFlags()，它会被所有子命令继承（比如全局--config），flag没有等价机制 -
cobra的 flag 默认带 help 文本，且会自动出现在--help输出中；flag需手动设flag.Usage才能定制帮助格式
性能与构建体积的实际影响
对绝大多数 CLI 工具来说，cobra 带来的二进制体积增加（约 1–2 MB）和启动延迟（纳秒级）几乎不可感知。真正影响体验的是开发效率和后期扩展性：
- 加一个新子命令，
cobra只需新建文件、AddCommand一行，flag得手动解析os.Args[1]、写 if-else 分支、重复处理 help 和 error -
cobra自动生成的--help支持嵌套展示（go-fly server --help显示 server 特有 flag），flag只能输出全部 flag，不管当前是否相关 - 如果项目未来要支持 shell 自动补全（bash/zsh），
cobra一行rootCmd.GenBashCompletionFile就搞定，flag得从头实现
真正难搞的是混合使用：比如在 cobra 的 Run 里又调了一次 flag.Parse() —— 这会导致参数被重复解析、flag 冲突、help 信息错乱，必须避免。
