使用 Homebrew, Nix 安装 goctl

项目链接

• 主页
• 仓库
• 上游文档
• 软件包管理器页面

命令和别名

• goctl

项目历史

The go-zero repository was created in August 2020. Its README says the framework grew from an early 2018 transition from a Java and MongoDB monolith to Go microservices, with goctl serving as the code-generation tool around go-zero's API description syntax.

goctl evolved as a tool module inside the go-zero repository. Official documentation describes it as go-zero's code generation tool for HTTP services, gRPC services, models, Dockerfiles, Kubernetes manifests, and related workflow tasks.

采用历史

go-zero became a large Go framework project, with GitHub repository metadata showing more than thirty thousand stars by June 2026. goctl's adoption is tied to that framework: users installing go-zero for API and RPC services also install goctl to generate the boilerplate that keeps services consistent.

Distribution follows both Go and package-manager norms. The official README documents `go install github.com/zeromicro/go-zero/tools/goctl@...`, Homebrew installation with `brew install goctl`, and a Docker image path.

使用方式

Typical usage begins by creating a `.api` file, running `goctl api go -api ... -dir ...`, and then running the generated Go service. The README's quick start shows goctl generating handler, logic, config, service-context, and type files for an HTTP API.

The CLI reference groups goctl commands around API generation, RPC generation, model generation, Docker, Kubernetes, environment checks, config, templates, naming style, Swagger, upgrades, migration, shell completion, and bug reporting.

为什么软件包爱好者会关心

Package nerds care about goctl because it is a generator packaged separately from the framework it serves. That split lets a team pin or install the CLI through Homebrew, Go tooling, or Docker while generated services depend on normal Go modules.

It is also a good example of spec-driven development in a package ecosystem: the `.api` file becomes a compact source artifact, and goctl expands it into a repeatable service layout.

时间线

• 2018: go-zero's README describes the internal microservices transition that motivated the framework.
• 2020-08: go-zero GitHub repository created.
• 2025-10: goctl v1.9.2 release tag published under tools/goctl.
• 2026-02: goctl v1.10.0 release tag published.
• 2026-03: goctl v1.10.1 release tag published.

Related projects

• go-zero is the framework goctl serves.
• Protocol Buffers and gRPC are part of the RPC generation workflow.
• mcp-zero, ai-context, and zero-skills are related go-zero projects for AI-assisted framework-compliant development.

来源

• https://api.github.com/repos/zeromicro/go-zero
• https://api.github.com/repos/zeromicro/go-zero/releases
• https://github.com/zeromicro/go-zero
• https://github.com/zeromicro/go-zero/releases
• https://go-zero.dev/getting-started/
• https://go-zero.dev/reference/cli-guide/