有位同学在群里说：“Go-Zero官方文档太简洁了，对小白有点不友好。好奇你们是怎么学习的？项目是怎么封装的？有什么提高开发效率的技巧吗？”。
来来来，这期内容给你安排上，先教你goctl的妙用！
前两篇文章分享了 Go-Zero微服务快速入门和最佳实践（一） 和 Go-Zero从0到1实现微服务项目开发（二）。
本文将继续深入探讨Go-Zero的强大，并带你从0到1学会使用goctl。
通过本文的教程，你将能够亲自实践并完成goctl生成模板代码，进一步提升你的开发效率。
goctl 是 go-zero 的内置脚手架，是提升开发效率的一大利器，可以一键生成代码、文档、部署 k8s yaml、dockerfile 等。
官方文档：goctl 安装 | go-zero Documentation
go install github.com/zeromicro/go-zero/tools/goctl@latest
goctl --version
接下来和我使用goctl实现快速搭建api服务、rpc服务脚手架以及model代码的生成：
goctl api是goctl中的核心模块之一，通过该命令可以快速生成一个api演示项目。
我们可以通过goctl api --help查看goctl api的所有指令。
goctl api --help
用于快速生成 Go HTTP 服务，需要指定服务名称，输出目录为当前工作目录。
goctl api new demo
这样在当前目录下就能够生成demo的api服务了。
下图为生成的项目目录结构:
func (l *DemoLogic) Demo(req *types.Request) (resp *types.Response, err error) {
// todo: add your logic here and delete this line
return &types.Response{
Message: "hello world",
}, nil
}
# 跳到demo服务根目录
cd demo
# 启动服务（默认8888端口，可在etc/demo-api.yaml配置）
go run demo.go -f etc/demo-api.yaml
http://localhost:8888/from/you
至此一个Go-Zero的单体服务就完成啦。
goctl api doc -dir ./
根据api文件生成Go HTTP代码。-api表示api文件路径，-dir表示代码输出目录，--style表示输出文件和目录的命名风格格式化符号。
详情见 文件风格
--home表示自定义模板文件目录（自定义模板我们会在后续进行讲解，别忘了关注我）
type PostDemoReq {
Message string `json:"message"`
}
type PostDemoResp {
Message string `json:"message"`
}
service demo-api {
@handler PostDemoHandler
post /postDemo(PostDemoReq) returns (PostDemoResp)
}
cd demo
goctl api go -api demo.api -dir . -style gozero
会生成这两个文件
func (l *PostDemoLogic) PostDemo(req *types.PostDemoReq) (resp *types.PostDemoResp, err error) {
// todo: add your logic here and delete this line
return &types.PostDemoResp{
Message: req.Message,
}, nil
}
go run demo.go -f etc/demo-api.yaml
至此我们已经学会怎么创建单体服务，并创建get和post接口啦，已经能应对大多数单体项目的开发需求。
当然我们做接口测试的时候一个个手动输入到ApiFox十分麻烦，这时候我们可以借助goctl api的插件生成swagger导入到ApiFox当中。
goctl-swagger 用于一键生成 api 的 swagger 文档
安装goctl-swagger
GOPROXY=https://goproxy.cn/,direct go install github.com/zeromicro/goctl-swagger@latest
使用goctl-swagger生成swagger.json
goctl api plugin -plugin goctl-swagger="swagger -filename demo.json" -api demo.api -dir .
生成如下文档
6.进行接口测试
goctl rpc 是 goctl 中的核心模块之一，其可以通过 .proto 文件一键快速生成一个 rpc 服务，如果仅仅是启动一个 go-zero 的 rpc 演示项目， 你甚至都不用编码，就可以完成一个 rpc 服务开发及正常运行。
goctl rpc new RPCDemo
用于快速生成一个 proto 模板文件，其接收一个 proto 文件名称参数。
goctl rpc -o demoProto.proto
cd .\RPCDemo
goctl rpc protoc RPCDemo.proto --go_out=./ --go-grpc_out=./ --zrpc_out=./ --style=goZero
func (l *PingLogic) Ping(in *rPCDemo.Request) (*rPCDemo.Response, error) {
// todo: add your logic here and delete this line
return &rPCDemo.Response{
Pong: in.Ping,
}, nil
}
cd .\RPCDemo
go run .
将proto导入ApiFox进行测试
goctl model 为 goctl 提供的数据库模型代码生成指令，目前支持 MySQL、PostgreSQL、Mongo 的代码生成，MySQL 支持从 sql 文件和数据库连接两种方式生成，PostgreSQL 仅支持从数据库连接生成。
本文主要以MySQL为数据表来源生成代码，其他数据库类似。
goctl model mysql datasource -url="root:PXDN93VRKUm8TeE7@tcp(127.0.0.1:33069)/lottery" -table="lottery" -dir="./genModel" -cache=true --style=goZero
至此我们成功使用goctl model根据数据库中的数据表生成了model 代码。
后续通过修改模板代码我们可以实现生成代码的定制化需求，记得关注我！
这篇文章相比官方文档，详细介绍了如何使用Go-Zero的goctl工具进行api服务、rpc服务和model层代码的生成，以及生成swagger文件，并提供了Demo进行实际操作。
我将继续更新Go-Zero系列文章，如果你对Go语言或者微服务感兴趣，欢迎关注我，也欢迎直接私信我。
微信：wangzhongyang1993
gozero如何自定义goctl？本文详解和实战，通过本文你将了解goctl的妙用，提高你的开发效率。介绍如何使用goctl工具实现模板定制化，并根据实际项目业务需求进行模板定制化实现。