Go轻量命令行解析应优先用标准库flag包，通过FlagSet分治子命令，封装配置结构体并解耦依赖，兼顾可维护性与终端用户体验。
Go语言实现轻量级命令行参数解析器，关键不在堆功能，而在理清边界、用对工具、保持可维护性。标准库 flag 已足够支撑绝大多数场景，无需一上来就引入 cobra 或其他框架。
用好 flag 包：够用、清晰、无依赖
Go 标准库的 flag 包设计简洁，支持字符串、整数、布尔、浮点等基础类型，自动处理 -h/--help、类型校验和默认值。它不负责子命令路由或配置文件加载，这反而是优势——职责单一，代码透明，出问题容易定位。
- 用
flag.String("name", "default", "description")定义参数，返回指针，避免拷贝 - 短选项（如
-v）和长选项（如--verbose）可共存，只需在注册时统一命名逻辑 - 调用
flag.Parse()后，未被识别的参数自动进入flag.Args()，适合接收位置参数（如文件路径、命令名） - 错误提示由
flag自动输出，格式规范，用户一看就懂
子命令场景：用 FlagSet 分而治之
当工具需要类似 git add、git commit 的多命令结构时，不必强套重型框架。Go 原生支持通过多个 flag.FlagSet 实现模块化解析。
- 根据
os.Args[1]判断子命令名，例如"build"或"clean" - 为每个子命令创建独立的
flag.NewFlagSet，各自定义专属参数 - 主流程只做路由分发，业务逻辑与参数解析完全解耦，便于单元测试和复用
- 示例中常见模式：根命令解析全局选项（如
--debug），子命令解析自身参数（如--output）
输出与错误：面向终端用户的实际体验
参数解析只是起点，后续的输出格式和错误反馈直接影响工具是否“好用”。轻量不等于简陋，该有的体验不能省。
立即学习“go语言免费学习笔记（深入）”；
- 支持双输出模式：默认文本（
fmt.Printf） + 可选 JSON（json.Encoder），方便脚本集成 - 所有错误信息写入
os.Stderr，并以error:开头，便于 shell 脚本识别 - 业务校验失败时，不 panic，而是打印明确提示后调用
os.Exit(1) - 帮助信息中加入真实示例，比如
copaw json get config.json --path=.server.port，比抽象描述更有效
扩展性留白：不预设，但可插
真正的轻量，是现在够用，将来好加。不需要内置 YAML 配置或彩色日志，但要预留接口。
- 将参数解析结果封装为结构体（如
type Config struct { Verbose bool; Output string }），而非散落全局变量 - 核心逻辑函数接收该结构体作为唯一参数，便于未来注入配置或 mock 测试
- 日志、HTTP 客户端等外部依赖通过接口传入，不硬编码
log.Println或http.DefaultClient - 这样，后续若需接入 viper 配置、slog 日志或自定义 HTTP transport，改动范围可控
