使用Golang结合Cobra框架可高效构建CLI工具，推荐清晰的项目结构（cmd/、internal/、main.go），通过Cobra实现子命令与参数解析，利用Go静态编译和跨平台特性生成多系统二进制文件，便于打包发布。
用Golang开发命令行工具是很多开发者都会遇到的场景，尤其适合写自动化脚本、运维工具、代码生成器等。Go语言本身编译快、依赖少、跨平台支持好，非常适合构建轻量高效的小型CLI应用。下面从项目结构、参数解析、子命令设计到打包发布，一步步带你实践。
项目结构设计
一个清晰的目录结构有助于后期维护和扩展。对于中小型CLI工具，推荐如下结构：
mycli/
├── cmd/
│ └── root.go
│ └── version.go
│ └── serve.go
├── internal/
│ └── util/
│ └── file.go
├── main.go
└── go.mod
说明：
- cmd/ 存放各个命令逻辑，每个文件对应一个子命令
- internal/ 放内部共用逻辑，不对外暴露
- main.go 只负责初始化并执行根命令
使用 Cobra 管理命令
Cobra 是 Go 中最流行的 CLI 框架，支持子命令、标志位、自动帮助文档等功能。安装方式：
立即学习“go语言免费学习笔记（深入）”；
go get github.com/spf13/cobra
在 cmd/root.go 中定义主命令：
package cmd
import (
“fmt”
“github.com/spf13/cobra”
)
var rootCmd = &cobra.Command{
Use: “mycli”,
Short: “A simple CLI tool”,
Run: func(cmd *cobra.Command, args []string) {
fmt.Println(“Hello from mycli!”)
}
}
func Execute() {
if err := rootCmd.Execute(); err != nil {
fmt.Println(err)
os.Exit(1)
}
}
在 main.go 中调用：
package main
import “mycli/cmd”
func main() {
cmd.Execute()
}
添加子命令与参数
比如添加一个 version 命令显示版本信息：
var versionCmd = &cobra.Command{
Use: “version”,
Short: “Print the version number”,
Run: func(cmd *cobra.Command, args []string) {
fmt.Println(“mycli v0.1.0”)
}
}
func init() {
rootCmd.AddCommand(versionCmd)
}
支持标志位也很简单：
var verbose bool
rootCmd.Flags().BoolVarP(&verbose, “verbose”, “v”, false, “enable verbose mode”)
在 Run 函数中即可使用 verbose 变量判断是否开启详细日志。
构建与发布
Go 编译出的是静态二进制文件，直接运行即可：
go build -o mycli main.go
为不同平台交叉编译也很方便：
# Linux
GOOS=linux GOARCH=amd64 go build -o mycli-linux-amd64
# macOS
GOOS=darwin GOARCH=amd64 go build -o mycli-darwin-amd64
# Windows
GOOS=windows GOARCH=amd64 go build -o mycli.exe
可以写个 shell 脚本一键打包所有平台，便于发布。
基本上就这些。用 Cobra 搭骨架，Go 编译打包装，一个实用的命令行工具就能快速上线。关键是结构清晰、接口明确，后续加功能也不容易乱。
linux git go windows github golang go语言 工具 mac ai amd macos golang print String if 接口 internal Go语言 var nil number github windows linux 自动化