SuperAPI AI 工具集

golang-cli

编程与开发

查看项目

更新于 10-16 08:44

技能介绍

用途:用于构建、修改或审查 Go CLI 工具,重点关注命令结构、标志处理与配置管理。定位是让工具贴合 Unix shell 习惯,可组合、可脚本化、自动化下行为可预测。

主要能力与用法:默认技术栈为 Cobra(github.com/spf13/cobra)配合 Viper(github.com/spf13/viper),前者提供命令/子命令/标志结构,后者处理来自文件、环境变量与标志的配置分层;无子命令、标志极少的简单工具可用标准库 flag。项目结构建议命令放在 cmd/myapp/ 下,每个命令一个文件,main.go 保持精简,只调用 Execute()。根命令通过 PersistentPreRunE 初始化 Viper,必须设置 SilenceUsage: true 与 SilenceErrors: true,日志走 stderr、输出走 stdout。子命令在 init() 中注册;标志分为 Persistent(如 --config)与 Local(如 --port),可用 MarkFlagRequired、MarkFlagsMutuallyExclusive 等约束,并始终用 BindFlag 绑定到 Viper,使其按标志、环境变量、配置文件、默认值顺序解析。参数校验可用 cobra.NoArgs、ExactArgs、MinimumNArgs、MaximumNArgs、RangeArgs、ExactValidArgs 等内置校验器。版本建议通过 go build -ldflags 在编译期注入。退出码遵循 Unix 约定,如 0 成功、1 一般错误、2 用法错误、126 无法执行、127 命令未找到、128+N 信号终止。支持 os.ModeCharDevice 检测管道与终端、--output 提供 table/json/plain、fatih/color 自动在非终端禁用颜色、signal.NotifyContext 处理信号、自动生成 bash/zsh/fish/PowerShell 补全。测试时使用 cmd.OutOrStdout() 与 cmd.ErrOrStderr() 捕获输出。

常见限制与注意事项:避免直接写 os.Stdout、在 RunE 中调用 os.Exit、不绑定标志到 Viper、缺少 viper.SetEnvPrefix、日志写 stdout、每个错误都打印用法、强制要求配置文件、硬编码版本号、不支持 --output 等。使用 Cobra/Viper 时请参考官方文档获取当前 API 签名。技能中提到的辅助库还包括 pflag、tablewriter、bubbletea 与 goreleaser;具体安装命令与代码示例资料未提供,暂未提供。