Go命令行应用开发指南

Go命令行应用开发

1. 标准库实现方式

1.1 使用flag包

最基本的命令行参数处理方式：

import (
    "flag"
    "fmt"
)

func main() {
    name := flag.String("name", "World", "A name to say hello to")
    flag.Parse()
    fmt.Printf("Hello, %s!\n", *name)
}

使用示例：

./app -name Alice
# 输出: Hello, Alice!

1.2 使用os.Args

直接访问命令行参数：

import (
    "fmt"
    "os"
)

func main() {
    if len(os.Args) > 1 {
        fmt.Printf("Hello, %s!\n", os.Args[1])
    } else {
        fmt.Println("Hello, World!")
    }
}

使用示例：

./app Alice
# 输出: Hello, Alice!

1.3 标准输入输出

实现交互式命令行：

import (
    "bufio"
    "fmt"
    "os"
)

func main() {
    reader := bufio.NewReader(os.Stdin)
    fmt.Print("Enter your name: ")
    name, _ := reader.ReadString('\n')
    fmt.Printf("Hello, %s", name)
}

2. 第三方库实现

2.1 使用Cobra

功能强大的命令行框架：

import (
    "fmt"
    "github.com/spf13/cobra"
)

var rootCmd = &cobra.Command{
    Use:   "app",
    Short: "A brief description of your application",
    Long: `A longer description that spans multiple lines and likely contains
examples and usage of using your application.`,
    Run: func(cmd *cobra.Command, args []string) {
        fmt.Println("Hello from Cobra!")
    },
}

func main() {
    rootCmd.Execute()
}

Cobra特性：
- 支持嵌套子命令
- 全局和本地标志
- 智能建议
- 自动生成命令和标志补全
- 自动生成帮助信息

2.2 使用urfave/cli

轻量级的命令行框架：

import (
    "fmt"
    "github.com/urfave/cli/v2"
    "os"
)

func main() {
    app := &cli.App{
        Name:  "greet",
        Usage: "fight the loneliness!",
        Action: func(c *cli.Context) error {
            name := "World"
            if c.NArg() > 0 {
                name = c.Args().Get(0)
            }
            fmt.Printf("Hello, %s!\n", name)
            return nil
        },
    }

    app.Run(os.Args)
}

urfave/cli特性：
- 子命令支持
- 标志和参数处理
- 帮助文本生成
- 命令别名

3. 选择指南

3.1 使用标准库的场景

• 简单的参数处理
• 基本的交互需求
• 轻量级应用
• 无需复杂命令结构

3.2 使用Cobra的场景

• 复杂的命令行应用
• 需要子命令支持
• 需要完整的CLI框架
• 企业级应用

3.3 使用urfave/cli的场景

• 中等复杂度的应用
• 需要基本的CLI框架
• 介于标准库和Cobra之间
• 快速开发原型

4. 最佳实践

1. 命令设计
   - 使用直观的命令名称
   - 提供清晰的帮助信息
   - 支持命令简写
   - 合理设置默认值

2. 错误处理
   - 提供友好的错误信息
   - 实现优雅的退出机制
   - 添加调试信息输出
   - 支持不同的日志级别

3. 用户体验
   - 添加进度显示
   - 实现命令补全
   - 提供交互式模式
   - 支持配置文件

5. 进阶功能

1. 配置管理
   - 支持配置文件
   - 环境变量集成
   - 多环境配置

2. 输出美化
   - 颜色输出
   - 进度条显示
   - 表格格式化
   - 交互式菜单

3. 调试支持
   - 详细日志输出
   - 性能分析
   - 调试模式
   - 错误追踪