https://github.com/jzero-io/jzero
扩展 go-zero 框架，能通过内置模板或自定义模板一键创建项目，并基于 proto/api/sql 等可描述文件生成服务端/客户端代码，开箱即用并高度可定制化.
https://github.com/jzero-io/jzero
api cloud-native cobra code-generation go go-zero grpc grpc-gateway microservice proto sqlbuilder validator
Last synced: 23 days ago
JSON representation
扩展 go-zero 框架，能通过内置模板或自定义模板一键创建项目，并基于 proto/api/sql 等可描述文件生成服务端/客户端代码，开箱即用并高度可定制化.
- Host: GitHub
- URL: https://github.com/jzero-io/jzero
- Owner: jzero-io
- License: mit
- Created: 2024-04-07T02:07:56.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2026-01-13T09:56:14.000Z (26 days ago)
- Last Synced: 2026-01-13T18:26:35.827Z (25 days ago)
- Topics: api, cloud-native, cobra, code-generation, go, go-zero, grpc, grpc-gateway, microservice, proto, sqlbuilder, validator
- Language: Go
- Homepage: https://docs.jzero.io
- Size: 28 MB
- Stars: 125
- Watchers: 4
- Forks: 13
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
- awesome-zero - jzero - 基于 go-zero 框架定制的企业级后端代码框架脚手架, 同时支持使用 go-zero rpc, gateway, api 特性, 支持多 proto 多 service, 多人开发友好. 并能完全同步 go-zero 新特性. [文档](https://jzero.jaronnie.com) (Libraries that use [go-zero](https://github.com/tal-tech/go-zero))
README
# jzero
[](https://github.com/jzero-io/jzero/actions?query=workflow%3Ajzero-ci)
[](https://github.com/jzero-io/jzero/releases/latest)
[](https://github.com/marketplace/actions/jzero-action)
[](https://vercel.jaronnie.com/api/v1/shields/github/jzero-io/jzero/pkgs/container/jzero/downloads)
[](https://deepwiki.com/jzero-io/jzero)
## 简介
基于 [go-zero框架](https://github.com/zeromicro/go-zero) 以及 [go-zero/goctl工具](https://github.com/zeromicro/go-zero/tree/master/tools/goctl) 开发的 [jzero](https://github.com/jzero-io/jzero) 框架, 可一键初始化 api/gateway/rpc 项目, 并基于可描述文件(**api/proto/sql**)自动生成**服务端和客户端**代码, 降低开发心智, 解放双手!
具备以下特点:
* 支持通过**配置文件/命令行参数/环境变量**组合的方式灵活控制 jzero 的各项配置, 极简指令生成代码, ai 友好
* 支持基于 **git 对改动文件**生成代码, 支持对**指定描述文件**生成代码或**忽略指定描述文件**生成代码, 提升大型项目代码生成效率
* 内置常用开发模板并增强模板特性, 支持**自定义模板**, 构建专属企业内部代码模板, 极大降低开发成本
更多详情请参阅：[https://docs.jzero.io](https://docs.jzero.io)
## 设计理念
* **开发体验**: 提供简单好用的一站式生产可用的解决方案, 提升开发体验感
* **模板驱动**: 所有代码生成均基于模板渲染, 默认生成即最佳实践, 且支持自定义模板内容
* **生态兼容**: 不修改 go-zero 和 go-zero/goctl, 保持生态兼容, 同时解决已有的痛点问题并扩展新的功能
* **团队开发**: 通过模块**分层**, **插件**设计, 团队开发友好
* **接口设计**: 不依赖特定数据库/缓存/配置中心等基础设施, 根据实际需求自由选择
更多详情请参阅：https://docs.jzero.io
## 快速开始
```shell
# 安装 jzero
go install github.com/jzero-io/jzero/cmd/jzero@latest
# 一键安装所需的工具
jzero check
# 一键创建项目
jzero new your_project
cd your_project
# 下载依赖
go mod tidy
# 启动服务端程序
go run main.go server
# 访问 swagger ui
http://localhost:8001/swagger
```
### docker
```shell
# 一键创建项目
docker run --rm -v ${PWD}:/app ghcr.io/jzero-io/jzero:latest new your_project
cd your_project
# 下载依赖
go mod tidy
# 启动服务端程序
go run main.go server
# 访问 swagger ui
http://localhost:8001/swagger
```
更多示例代码请参阅: https://github.com/jzero-io/examples
## 生态
* jzero-intellij(jzero 的 goland 插件): https://github.com/jzero-io/jzero-intellij
* jzero-admin(基于 jzero 的后台管理系统): https://github.com/jzero-io/jzero-admin
更多生态请查阅: [https://docs.jzero.io/ecosystem](https://docs.jzero.io/ecosystem)
## 贡献者
[贡献](https://docs.jzero.io/guide/contribute.html)
## Stargazers over time
[](https://star-history.com/#jzero-io/jzero&Date)
## 免责声明
jzero 基于 MIT License 发布，完全免费提供。作者及贡献者不对使用本软件所产生的任何直接或间接后果承担责任，包括但不限于性能下降、数据丢失、服务中断、或任何其他类型的损害。
无任何保证：本软件不提供任何明示或暗示的保证，包括但不限于对特定用途的适用性、无侵权性、商用性及可靠性的保证。
用户责任：使用本软件即表示您理解并同意承担由此产生的一切风险及责任。