本文详解 go-flags 库中命令层级结构（如 ex list todos --completed）的正确建模方式：list 是一级子命令，todos/events 是二级子命令（而非参数），--completed 是布尔型选项，需通过嵌套结构体定义。

本文详解 go-flags 库中命令层级结构（如 `ex list todos --completed`）的正确建模方式：`list` 是一级子命令，`todos`/`events` 是二级子命令（而非参数），`--completed` 是布尔型选项，需通过嵌套结构体定义。

在 go-flags 中，CLI 命令树必须严格通过结构体嵌套来建模——每个命令层级对应一个结构体字段，且该字段类型必须为指针或嵌入结构体，不能将 todos 或 events 当作普通字符串参数传递。--completed 则属于典型的命令级选项（Option），应定义为结构体字段并打上 long:"completed" 标签。

以下是一个完整可运行的示例，实现 ex list todos --completed 和 ex list events 等用法：

Free Ride - Unlimited free AI

一款AI工具，主要用于管理 OpenClaw 所使用的来自 OpenRouter 的免费 AI 模型。自动按质量对模型进行排序，配置回退机制以应对速率限制，并更新 opencla...，适合需要提升相关任务效率的用户。

下载

package main

import (
    "fmt"
    "os"
    "github.com/jessevdk/go-flags"
)

// 主命令结构体（对应 ex）
type Options struct {
    List       *ListCommand       `command:"list" alias:"l" description:"List resources"`
    Authenticate *AuthCommand     `command:"authenticate" alias:"auth" description:"Authenticate user"`
}

// list 子命令结构体（一级子命令）
type ListCommand struct {
    Todos      *TodosCommand      `command:"todos" description:"List todos"`
    Events     *EventsCommand     `command:"events" description:"List events"`
}

// todos 二级子命令（支持 --completed 选项）
type TodosCommand struct {
    Completed bool `long:"completed" short:"c" description:"Show only completed todos"`
}

func (t *TodosCommand) Execute(args []string) error {
    if t.Completed {
        fmt.Println("Listing completed todos...")
    } else {
        fmt.Println("Listing all todos...")
    }
    return nil
}

// events 二级子命令（无额外选项）
type EventsCommand struct{}

func (e *EventsCommand) Execute(args []string) error {
    fmt.Println("Listing events...")
    return nil
}

// authenticate 子命令
type AuthCommand struct{}

func (a *AuthCommand) Execute(args []string) error {
    fmt.Println("Authenticating...")
    return nil
}

func main() {
    parser := flags.NewParser(&Options{}, flags.Default)
    _, err := parser.Parse()
    if err != nil {
        os.Exit(1)
    }
}

✅ 关键要点说明：

• ListCommand 中的 Todos 和 Events 字段必须为指针类型（*TodosCommand），否则 go-flags 不识别其为子命令；
• 每个子命令结构体需实现 Execute([]string) error 方法，这是命令实际执行逻辑的入口；
• --completed 是 TodosCommand 的字段，通过 long:"completed" 标签注册为长选项，short:"c" 同时支持 -c 缩写；
• go-flags 自动支持 ex list todos --help 等内置帮助，无需手动实现；
• 不支持 ex list todos events 这种“多命令并列”调用（因 todos 和 events 是互斥子命令），若需同时操作多资源，应改用参数设计（如 ex list --resources todos,events）或自定义解析逻辑。

⚠️ 注意：go-flags 的设计理念是命令树驱动，而非自由参数组合。试图将 todos events 作为位置参数传入 list 命令会破坏层级语义，应优先通过明确的子命令结构表达意图。如确需灵活资源选择，建议在 ListCommand 中定义 Resources []string 字段配合 positional-arg-name:"resource" 标签，并禁用子命令解析（subcommands: false）。