项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-10-07 · 当前星标 ★ 33436
使用教程
环境要求
- 已安装 Go 环境,并能使用 go get / go install(GOPATH/bin 需在 $PATH 中)
- 需要安装 goctl 命令行工具,且保证其可执行并位于 $PATH 中
- 若不想本地安装 goctl,可用 Docker 运行 kevinwan/goctl 镜像
- Mac 用户可直接用 brew 安装 goctl
安装与启动步骤
-
1获取 go-zero 依赖
在项目目录下执行,把 go-zero 框架依赖拉取到当前项目。这是 README 给出的 Installation 命令。
go get -u github.com/zeromicro/go-zero -
2安装 goctl 工具
在 Quick Setup 与 Quick Start 中均给出该命令;安装完成后 goctl 会位于 GOPATH/bin,需确保该目录在 $PATH 中。
go install github.com/zeromicro/go-zero/tools/goctl@latest -
3验证 goctl 可用
查看版本号确认命令能正常执行。若提示 command not found,说明 GOPATH/bin 未加入 $PATH。
goctl --version -
4生成 api 模板
用 goctl 生成 greet.api 描述文件模板,随后可按 README 示例编写 Request/Response 与 service 路由。
goctl api -o greet.api -
5生成 Go 服务代码
根据 greet.api 一键生成项目骨架,包含 etc 配置、handler 路由、logic 业务逻辑、types 结构体等目录。
goctl api go -api greet.api -dir greet -
6启动生成的服务
进入 greet 目录整理依赖并运行主程序,指定 etc 下的配置文件;默认监听 8888 端口。
cd greet go mod tidy go run greet.go -f etc/greet-api.yaml -
7请求验证接口
用 curl 访问生成的 /greet/from/:name 路由,返回 HTTP/1.1 200 OK 即表示服务正常。
curl -i http://localhost:8888/greet/from/you
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
Port | 否 | 服务监听端口,位于生成的 etc/greet-api.yaml 中,默认 8888 | 8888 |
etc/greet-api.yaml | 是 | 服务启动时通过 -f 指定的配置文件,承载可调整的配置项 | etc/greet-api.yaml |
如何确认成功
运行后服务在 8888 端口监听;执行 curl -i http://localhost:8888/greet/from/you,返回 HTTP/1.1 200 OK 即启动成功。
常见问题
Q:goctl 提示 command not found 怎么办?
A:确认已执行 go install 安装 goctl,并把 Go 的 GOPATH/bin 加入 $PATH;README 特别强调 goctl 需可执行且在 $PATH 中。
Q:不想本地安装 goctl 有替代方式吗?
A:README 提供 Docker 方式:docker pull kevinwan/goctl,再 docker run --rm -it -v `pwd`:/app kevinwan/goctl --help 运行。
Q:接口默认端口是多少,能改吗?
A:默认端口 8888,可在生成的 etc/greet-api.yaml 配置文件中修改。
Q:只能生成 Go 代码吗?
A:不是,README 示例还给出 goctl api java -api greet.api -dir greet、goctl api dart -api greet.api -dir greet 等客户端代码生成命令。
注意事项
- 所有命令均来自 README 的 Installation、Quick Setup 与 Quick Start 章节,未做额外扩展。
- 配置文件中的具体配置项名称以 goctl 实际生成的 etc/greet-api.yaml 内容为准,README 仅说明端口默认为 8888 且可在该文件中配置。
- 业务逻辑写在 internal/logic 包中,MySQL、Redis 等依赖通过 internal/svc/servicecontext.go 注入。
- README 还提到可参考 ai-context 与 zero-skills 集成指南配置助手工作流与模式库(需访问对应仓库页面)。
核心亮点
- goctl 根据 .api/.proto 一键生成服务骨架、路由、客户端与 CRUD 代码,显著减少样板代码
- 内置自适应熔断、限流、负载均衡、自动缓存管理等微服务治理能力,开箱即用
- 同时覆盖 HTTP 与 gRPC,并提供网关、配置、日志、链路追踪等完整工程化组件
不足之处
- 框架约定较强,项目结构与生成代码风格绑定较深,深度定制或迁移成本偏高
- 相比 Gin、Kratos 等,部分高级治理能力与生态插件仍依赖官方组件,社区第三方扩展相对有限
适用场景
- 快速搭建多服务微服务后端并统一治理
- 用 goctl 从接口描述生成 HTTP/gRPC 服务与客户端
- 云原生业务中需要熔断限流与自动缓存的 API 服务
替代项目
Kratos、go-micro、Gin
上一篇:muse-gadget-sdk
下一篇:rigging
同类项目推荐
alf
开源
统一框架搭建智能体学习训练管线
Agent Learning Framework https://alf.readthedocs.io
stop-that-shit
开源
拦住 Codex 乱加依赖,让 AI 改动保持精简。
Stop That Shit(别再造史了)|面向 Codex/GPT 场景的多平台 Hook + Skill Guard:拦截 A···
TANGO
开源
不写代码,自动生成并运维目标导向的神经网络。
public repo for TANGO (Target Aware No-code neural network Generation and Operation ···
fragments
开源
用 AI 一句话生成完整 Next.js 应用,快速搭建全栈原型
Open-source Next.js template for building apps that are fully generated by AI. By E2···
NextTransformer
开源
同算力下公平对比 Transformer 新架构
:sunrise: A comprehensive, cutting-edge open-source framework for next-generation Tr···
autogpt
开源
用 Rust 打造你的专属 AGI 代理,高性能且安全。
A Pure Rust Framework For Building AGI.
go-astibob
开源
用 Go 快速搭建能听会说的 AI 助手
Golang framework to build an AI that can understand and speak back to you, and every···
tambo
开源
让 AI 回复直接变成可点的 React 界面
Generative UI SDK for React
Agentic-Workflow-Patterns
开源
照着用,快速搭出生产级 Python 智能体工作流
Repository demonstrating best practices and patterns for implementing agentic workfl···
