使用Golang开发命令行工具高效实用,结合Cobra和Viper可快速构建专业CLI。2. 项目初始化后,采用标准结构,通过Cobra实现子命令与标志解析,Viper管理配置文件与环境变量。3. 支持多平台交叉编译,利用goreleaser自动化打包发布至GitHub,实现全流程清晰、配置灵活、发布便捷的工具交付。

用Golang开发命令行工具是高效且实用的选择,语言本身简洁、编译快、跨平台支持好。下面是一个完整的实现流程,从项目初始化到发布,涵盖常用功能和最佳实践。
项目初始化与结构设计
创建项目目录并初始化模块:
mkdir mycli && cd mycligo mod init mycli
推荐的项目结构:
- main.go:程序入口
- cmd/:存放子命令逻辑(如 add、list)
- internal/:私有业务逻辑
- pkg/:可复用的公共包
- config/:配置加载
main.go 示例:
立即学习“go语言免费学习笔记(深入)”;
package mainfunc main() {
if err := rootCmd.Execute(); err != nil {
fmt.Println(err)
os.Exit(1)
}
}
使用 Cobra 构建命令系统
Cobra 是 Go 中最流行的 CLI 框架,支持子命令、标志、自动帮助等。
安装 Cobra:
go get github.com/spf13/cobra@latest在 main.go 中初始化 rootCmd:
var rootCmd = &cobra.Command{Use: "mycli",
Short: "一个简单的命令行工具",
Run: func(cmd *cobra.Command, args []string) {
fmt.Println("欢迎使用 mycli!")
},
}
添加子命令(如 mycli add):
- 创建 cmd/add.go
- 定义 addCmd 并在 init() 中注册到 rootCmd
- 支持标志:cmd.Flags().StringP("name", "n", "", "名称")
运行时通过 cobra.Execute() 启动命令解析。
配置与参数管理
使用 spf13/viper 管理配置文件和环境变量。
安装 Viper:
go get github.com/spf13/viper@latest典型用法:
- 支持 yaml、json、toml 配置文件
- 自动查找 ~/.mycli/config.yaml 或 ./config.yaml
- 绑定命令行标志到配置项:
viper.BindPFlag("name", rootCmd.Flags().Lookup("name")) - 读取值:viper.GetString("name")
这样用户既可通过命令行传参,也可通过配置文件持久化设置。
构建与发布
编译为静态二进制文件,便于分发:
GOOS=linux GOARCH=amd64 go build -o mycli支持多平台交叉编译:
安装 goreleaser:
brew install goreleaser生成配置文件:
goreleaser init执行发布:
goreleaser --snapshot --clean它会自动构建多个平台的二进制、生成压缩包、上传 GitHub Release。
基本上就这些。从初始化到发布,Golang 命令行工具流程清晰,配合 Cobra 和 Viper 能快速构建专业级 CLI。关键是结构清晰、配置灵活、发布自动化。










