我用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

標籤：Go

上一篇：Erlang那些事兒 之 正兒八經的前言

下一篇：你還在用分頁？試試 MyBatis 流式查詢，真心強大！