用 Cobra 和 Viper 开发 Go CLI 工具的核心是命令结构清晰与配置灵活可靠：Cobra 管理命令树和参数解析，Viper 统一加载多源配置并按优先级合并，二者配合可快速构建生产级工具。
用 Cobra 和 Viper 开发 Go 命令行工具，核心是“命令结构清晰 + 配置灵活可靠”。Cobra 负责定义命令树、参数解析和帮助文本，Viper 负责统一加载配置（支持 YAML/TOML/JSON/环境变量/命令行标志），两者配合能快速构建生产级 CLI 工具。
初始化项目结构与 Cobra 根命令
从创建根命令开始，它代表整个 CLI 工具入口。使用 cobra-cli 可自动生成基础骨架：
- 安装工具：
go install github.com/spf13/cobra-cli@latest - 初始化项目：
cobra-cli init --pkg-name yourtool，生成cmd/root.go和main.go - 根命令默认启用
--help和--version，版本号建议通过var version = "v0.1.0"在root.go中定义并注入到cmd.Version - 避免在
init()中做重操作（如初始化数据库），改用PreRunE按需执行，保证 help 快速响应
添加子命令与参数绑定
子命令体现功能分层，例如 yourtool server start 或 yourtool config set key=value。关键点在于参数声明与使用分离：
- 在
cmd/xxx.go中调用cmd.Flags().StringP("port", "p", "8080", "HTTP server port")注册标志 - 在
RunE函数中用cmd.Flag("port").Value.String()或更推荐的viper.GetString("port")获取值（前提是已绑定） - 用
cmd.MarkFlagRequired("config")标记必填项，错误提示更友好 - 支持位置参数（如
yourtool run task1 task2）：在RunE中读取args参数切片
用 Viper 统一管理配置来源
Viper 的价值在于自动合并多来源配置，并按优先级覆盖（命令行 > 环境变量 > 配置文件 > 默认值）。集成时注意三点：
立即学习“go语言免费学习笔记（深入）”；
- 在
initConfig()中设置搜索路径：viper.AddConfigPath("./config")、viper.AddConfigPath("$HOME/.yourtool") - 支持多种格式：
viper.SetConfigName("config")+viper.SetConfigType("yaml")，然后调用viper.ReadInConfig() - 绑定标志前先调用
viper.BindPFlags(cmd.Flags())，这样viper.GetString("port")就能同时读取--port、PORT=8080或配置文件里的port: 8080 - 环境变量名默认大写加下划线（如
PORT对应port），可调用viper.SetEnvKeyReplacer(strings.NewReplacer("-", "_"))支持YOURTOOL_HTTP_PORT
错误处理、日志与用户反馈
CLI 工具的健壮性体现在清晰的错误传达和一致的输出风格：
- 所有
RunE函数返回error，Cobra 自动打印错误信息并退出非零状态码 - 避免裸写
fmt.Println，统一用cmd.OutOrStdout()和cmd.ErrOrStderr()输出，方便测试重定向 - 敏感操作（如
delete）增加--yes标志或交互式确认：fmt.Fprint(cmd.OutOrStdout(), "Confirm? (y/N): ") - 日志建议用
log/slog（Go 1.21+）或zap，但 CLI 日志级别通常只在--verbose下开启，避免干扰正常输出
