我用go-zero开发了第一个线上项目

作者：结冰

前言

​ 说在最前面，我是一个外表谦让，内心狂热，外表斯文，内心贪玩的一个普通人。我的职业是程序员，是一个golang语言爱好者，一半是因为golang好用，一半是因为其他语言学不好。我是从phper转为gopher的，写php的时候我认识了互联网软件，写go的时候感觉自己终于在编程。

初见golang

​ 我大学专业是软件。第一门编程语言是C++，知道了指针，知道了加减乘除，知道了编程去控制软硬件。后来选修了java，被ssh框架戏耍了一个暑假。再后来进入了一个社团技术部，再被html/css/js打击了自己信心。高中年级总能排名前几的我，真的开始怀疑人生了。再再后来进入了一家游戏平台公司，开始了php的编写之旅。“噢！”，终于，我知道了什么是互联网，折磨我的编程语言c++/java/html/css，原来还可以这样子“变现”。

​ 刚入门了互联网的我，心里是真的喜悦。不过，重复的东西做多了，总是少不了厌倦。每天都是写php，都是那些增删改查，都是修改数据表，增加字段，增加临时表。真的，开始腻了。“听说最新公司在用新的编程语言golang”，我，想去试试。但，我不敢，心里有对自己和对golang的怀疑，因此我不是第一个去拜师的。当golang在公司流行了两个月，我的leader让我去用一下golang。终于，我师出有名了。浅尝了一周的golang之后，我！！发现！！

1. golang是有指针的，这不是大学熟悉的C++那样的指针吗
2. golang是编译语言，原来客户端的“打包、打包”，原来是这么一回事
3. golang是可以做定时器的，换用php该怎么搞啊？很麻烦的吧。
4. golang不用写分号，不用写括号，看起来很简单啊，性能又很好啊！
5. golang原生支持web服务，原来不用nginx也可以起一个web服务啊
6. .......还有很多很多

喜欢golang

​ 尝试了golang之后，我发现我喜欢上了golang了。

golang严谨

​ golang中不提倡多余的变量。gopher都知道，golang变量不使用，直接会报编译错误！这让我刮目相看！在我看来，是把严谨提升了一个阶段，只要你是gopher，就会强迫你变得严谨。golang变量这个属性，秉承了golang的设计理念，严谨这个理念贯穿了golang的各处。

​ 曾经有一个CTO跟我说，定义的每一个变量、每一个字段，都应该有它的作用。多余的代码，多余的变量，多余的字段，除了误导别人，弄脏代码，别无他用。我，表示绝对赞同！

golang性能好

​ 单单靠golang的简单、严谨，当然上不了程序员的舞台。可恨的是，golang性能还很好！比C++要差点，但是就web应用的并发、资源占用来说，比java、python、php、nodejs都是要优秀的。具体数据大家上网一搜比比皆是。一个语法简单、性能又好、入门只需一周的语言，反正我是入坑了。

​ 有段时间，我太热爱golang了导致认为golang可以做任何事情。不过慢慢，我理性了。做web应用，首选golang。做数据分析、爬虫、图片处理还是python吧。但要是有人说用java去写web后台，cms类型还好，要是面向市场用户的，spring boot那套，spring cloud那套，我觉得，远远远远远远远比不上用golang相关的框架，java还是去做那些单体应用吧。

golang轻量

​ golang还有另外一个属性，就是“轻”，有多轻？对比一下java的jvm那套容器，你就知道有多轻了。几行代码就能实现一个原生web服务了，docker这个跨时代的产物就是golang写的。etcd这个分布式基石也是golang写的，云原生这个跨时代的名词，很多组件都是golang贡献的。“微服务”这个面试必问的名词，golang可以对它做最好的诠释。

go-zero一见如故

​ 后来我进入了一家直播公司，刚好遇到了公司的波动，让我有了停下来自省的时间。其间，喜欢逛逛github，稍有目的去逛一下golang的开源项目。比如gin，iris，go-micro，go-zero，sentinel-golang，gin-vue-admin等等等啦。一开始，go-zero并不是特别吸引我，可能是博客/github布局不够亮眼吧。但是，当我哪天沉下来看go-zero的文档，开始敲起第一个goctl的命令，我好像，好像！已经停不下来。

​ go-zero，用起来，真的很舒服！

​ 我刚在游戏平台公司实习转正的时候，也是可以带一两个实习生的。当时我就有个想法，“如何让员工都敲出规范、高效的代码”。当时想了下用go-template，但是因为学艺未精，推进不下去。时隔几年，当我接触到go-zero的goctl后，发现，居然有大佬实现了当年我的想法！虽然我技术不大行，但是梦想还是要有的，go-zero对我来说太亲切了。搞！肝！！

​ 一周时间，过完了go-zero的github文档以及语雀文档，中途也自己练手了几个demo。可真是越敲越舒服。迫不及待地用想找个实际项目投入生产！果真不久有个机会来了，公司想做一个简单的app做投放调研，允许重新搭建一个新的后台web项目，我！go-zero！义不容辞，开干。又花了两周时间，写完了一个后台web服务，里面有下面板块

1. 用户板块
2. 咨询板块
3. 报告板块
4. 支付板块
5. 广告板块

截个图看看我的项目结构，由于还是公司项目，暂时不会开源啦，不过凡是go-zeroer都能看懂

简单说明一下：

1. api目录，就是http1.1的web服务，跟前端对接
2. rpc目录，rpc服务，基本和api一一对应
3. enum目录，枚举目录，里面存放的是各种各样的枚举值，我把它提到一等公民了
4. model目录，数据库model，目前都是用goctl根据mysql生成的model
5. utils目录，这里主要存放我的一些小工具包，例如int/string/time的一些操作，参考了下go-zero的命名方法，子目录一般会以x结尾，例如intx，timex，stringx等等
6. worker目录，主要是做一些消费者模型的消费者，例如kafka的消费者，google订阅通知的消费者等等
7. ws目录，存放websocket相关的服务，例如私聊

感谢下go-zero，让我对项目的组织结构有了一个简单的标准。worker、ws等服务，以前的项目结构都杂乱无章，目前都是参考go-zero生成api的目录结构了：

1. main.go入口
2. etc存放配置，
3. internal内部目录
   1. config：配置
   2. handler：处理器
   3. logic：逻辑处理
   4. types：中间类型

go-zero理念

​ “工具大于约定和文档”，这，就是go-zero的理念。我，表示极度赞同！

​ go-zero的最大特点，就是goctl。goctl是什么？就是能根据协议文档，生成代码的一个神器。例如

1. 定了a.proto文件，goctl rpc proto a.proto -dir . 即可生成rpc服务

2. 定了b.sql文件，goctl model mysql ddl -c -src b.sql -dir . 即可生成模板model文件

3. 定了c.api文件（go-zero出品），goctl api go -api ad-api.api -dir . 即可生成api文件

   再配合上golang的jb IDE，代码提醒，代码格式化，一个go-zero的生态，就出来了。一个字：舒服！！

go-zero小工具

​ 除了goctl神器，另外一个让我拜服的点是，go-zero的一些小工具。

1. 流数据处理利器：fx。听说java8的lambda很炫酷，go-zero也有了！fx.Filter().Sort().Head() ，让数组的复杂处理变得简单
2. mapReduce降低服务相应时间：mr.Finish(), mr.Map().Reduce(), 跟并发处理waitGroup说拜拜！
3. etcd服务发现的集成：p2c的算法发现服务，免却了开发们点对点或nginx的转发服务，安装一个etcd就完事了
4. jwt集成api：轻松拥有一个jwt的后台服务
5. 集成Prometheus：轻松拥有一个带监控的golang后台服务
6. 等等等

二次感谢go-zero，还有很多小工具，等待我去看源码，时间轮/调度器等等啦。go-zero有点像我学习的导师一样。

go-zero拓展

​ go-zero为小白如我的gopher们，提供了一个功能完备、性能可观、开发迅速的web框架。然而，它不像其他框架那样约束着我，我还是能里面做很多发挥的。虽然不是大牛级别的发挥，但是，个性化操作还是支持的：

1. model层，完全可以接入gorm代替掉内置的sqlx，虽然就没了大佬辛苦做的缓存击穿等防护的功能。当然也可以两者并存。
2. rpc层，不必约定要api层去调用。例如我上面截图的worker/ws层去调用完全没问题。
3. api层自己生成的middleware，可以抽离出到公共目录，那就可以多个api目录使用同一个middlerware了。
4. 等等等啦

go-zero 很轻量、很便捷、很博学。里面蕴藏的着很多知识以及理念。目前我只是用了皮毛，go-zero的k8s部署，目前我没开始接入。继续努力努力学习啦！

再次感谢

1. https://www.yuque.com/tal-tech/go-zero/yaoehb go-zero语雀文档
2. https://github.com/tal-tech/go-zero go-zero源码

项目地址：
https://github.com/tal-tech/go-zero