Golang cobra怎么写命令行工具_Golang cobra CLI教程【技巧】-Golang-PHP中文网

go原生flag不支持多级子命令，因无法区分子命令与flag值、无自动help/version、全局flag冲突、位置参数需手动处理；cobra需改use、删冗余config flag、替换run实现，并为子命令设args规则、用stringp定义flag、加文件锁防数据丢失。

golang cobra怎么写命令行工具_golang cobra cli教程【技巧】

为什么不用原生 `flag` 写多级子命令

Go 原生 flag 包根本不是为 git commit -m "msg" 或 todo add "call mom" 这类结构设计的。它把 commit、add 当成未定义 flag 直接吃掉，或者要求你手动切 os.Args[1:] 判断子命令——一写就错，一改就崩。

flag.Parse() 后无法区分 myapp serve --port 8080 中的 serve 是子命令还是 flag 值
没有自动 --help / --version，得自己写 flag.Usage 并同步维护所有子命令文案
所有 flag 全局注册，todo list --done 和 todo rm --done 的 --done 会互相覆盖或冲突
位置参数（如文件名、任务内容）必须靠 flag.Args() 手动取，顺序错一位就全乱

`cobra init` 生成的代码必须立刻改哪三处

执行 cobra init todo 只是起点，骨架默认配置在真实项目里基本不能跑。不改这三处，轻则 help 显示错误命令名，重则静默退出或 panic。

改 rootCmd.Use：默认是 "todo"，但 Windows 下编译出 todo.exe，而 Use: "todo" 会让 todo --help 输出 Usage: todo [flags]，用户复制粘贴直接失败；应设为实际二进制名，比如 Use: "todo" 保持不变，但确保构建时不带 .exe 后缀参与解析（交叉编译时加 CGO_ENABLED=0）
删 rootCmd.PersistentFlags().StringVar(&cfgFile, "config", "", "config file")：除非真要支持 --config，否则徒增 flag、文档和用户困惑
替换 rootCmd.Run 空实现：删掉默认的 fmt.Println("not implemented")，换成 fmt.Fprintln(os.Stderr, "no subcommand specified"); os.Exit(1)，避免 todo 回车后啥也不报就退出

子命令里怎么安全收位置参数和 flag

Cobra 不会自动帮你判断 todo add "buy milk" 中的 "buy milk" 是参数还是 flag 值——它全靠你显式声明 Args 规则。漏设或设错，就会出现 todo upload file.txt --timeout 30 却收不到 file.txt 的问题。

Golang Naming

Go（Golang）命名规范 — 包括包、构造函数、结构体、接口、常量、枚举、错误、布尔值、接收器、getter/setter、函数等。

下载

必须为每个子命令设 Args 字段：Args: cobra.MinimumNArgs(1)（允许批量添加）或 Args: cobra.ExactArgs(1)（强制一个）
flag 定义用 StringP / Bool 等方法，别用 StringVar 绑定全局变量，避免跨命令污染
用户输入先 strings.TrimSpace()，再判空；空字符串跳过，不存也不报错，防止 JSON marshal 失败
写数据前用 ioutil.WriteFile(tmpPath, data, 0644)，成功后再 os.Rename()，避免崩溃导致 .todo.json 损坏

Windows 下找不到命令或 help 格式错乱怎么办

Go 默认在 Windows 编译出 todo.exe，但 Cobra 的 Use 字段只控制 help 文案里的命令名，不控制可执行文件名。如果用户在 cmd 里敲 todo list，系统找的是 todo（无后缀），不是 todo.exe——这就卡住了。

开发时统一用 go build -o todo（Linux/macOS）或 go build -o todo.exe（Windows），但 help 文案中仍写 Use: "todo"，保持跨平台一致
help 错乱常因没设 rootCmd.SetUsageFunc(customUsageFunc)，导致子命令 help 漏掉父级 flag（如全局 --verbose）
交叉编译务必加 CGO_ENABLED=0，否则 go build -o todo-linux 可能因 cgo 依赖失败
多个终端同时写 .todo.json 会丢数据——不是靠临时文件能解决的，得用 flock（Unix）或 syscall.LockFileEx（Windows）加写锁