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