1.介紹

Go 語言微服務框架 Kratos 是國內一款流行的 Go 語言微服務框架，本文我們一起重學 Kratos 的入門使用。

準備工作：

• 安裝 go[1]
• 安裝 protoc[2]
• 安裝 protoc-gen-go[3]
• 安裝 kratos 命令行工具[4]

2.創建項目

Go 語言微服務框架 Kratos 提供一個命令行工具，我們可以使用命令行工具快速創建項目，生成 proto 文件，生成 gRPC Client 和 gRPC Service 代碼，運行項目等。

Kratos 官方提供了一個項目模板倉庫，使用命令行工具創建項目時，默認使用官方提供的項目模板倉庫。

當然，它也支持自定義項目模板，我們可以把自定義項目模板提交到 Git 倉庫，使用命令行工具創建項目時，通過命令行參數 -r 指定自定義項目模板的 Git 倉庫地址。

使用命令行工具創建項目

我們使用 Kratos 官方提供的項目模板倉庫，如果讀者朋友們想要使用自定義項目模板，可以自行折騰。

kratos new helloworld
?? Creating service helloworld, layout repo is https://github.com/go-kratos/kratos-layout.git, please wait a moment.

正克隆到 '/Users/frank/.kratos/repo/github.com/go-kratos/kratos-layout@main'...

CREATED helloworld/.gitignore (552 bytes)
CREATED helloworld/Dockerfile (459 bytes)
// ...

閱讀上面這段代碼，我們可以發現使用 kratos new helloworld 創建項目時，默認使用官方提供的項目模板倉庫，同時還會將項目模板倉庫克隆到 $HOME/.kratos/repo/github.com/go-kratos/kratos-layout@main。

如果我們再次創建項目時，命令行工具應該會默認使用克隆到本地的項目模板。所以，如果大家在更換項目模板后，發現沒有生效，可以嘗試刪除克隆到本地的項目模板 rm -rf $HOME/.kratos。

需要注意的是，自定義項目模板中的 main.go 需要存放在 /cmd/server 目錄。不然命令行工具會報錯，也可以在項目根目錄創建 .kratos/layout.yaml，在配置文件中 cmd_dir 寫自定義項目模板中 main.go 存放的目錄。不過有可能踩坑！！！建議新手直接使用 Kratos 官方提供的項目模板。

Kratos 官方提供的項目模板中的 go.mod 文件，可能和我們本地的 go 版本不一致，建議手動刪除 go.mod，重新執行 go init helloworld 生成。

3.初始化項目

創建項目后，我們需要初始化項目，Kratos 微服務框架使用依賴注入 wire，我們需要安裝 wire（go get github.com/google/wire/cmd/wire@latest）。

除了直接使用 go get 方式安裝 wire 之外，還有 2 種方式，分別是執行 Makefile 中定義的 make init，和運行 go generate 執行項目模板代碼中的注釋指令 //go:generate。

在項目模板中，文件 cmd/helloworld/wire_gen.go 中包含 //go:generate 注釋指令：

// Code generated by Wire. DO NOT EDIT.

//go:generate go run -mod=mod github.com/google/wire/cmd/wire
//go:build !wireinject
// +build !wireinject

讀者朋友們可以按照自己的習慣選擇初始化項目的方式。

需要注意的是，正常情況下，該 3 種初始化項目的方式，都還需要進入 cmd/helloworld 目錄中，執行 wire，生成 wire_gen.go 中的代碼。

因為項目模板中，已包含 wire_gen.go 文件，并且該文件中的 //go:generate 注釋指令，會執行 go run -mod=mod github.com/google/wire/cmd/wire，所以不再需要在 cmd/helloworld 目錄中執行 wire。

4.編譯項目 & 運行項目

我們可以使用 go build 編譯項目 go build -o ./bin/ ./...，執行二進制文件運行項目 ./bin/helloworld -conf ./configs。

也可以使用命令行工具 kratos run 直接運行項目。

5.總結

本文從零開始講述 Kratos 微服務框架是入門使用方式，目標是可以將項目中的示例代碼 GreeterService.SayHello 方法成功運行。

讀者朋友們想要新創建一個方法，可以參考「Go 語言微服務框架 Kratos 開發 HTTP API」這篇文章。

實際上，主要分為 5 步：

• 創建 proto 文件；
• 生成 gRPC Client 和 gRPC Service 代碼；
• 注冊 HTTP 服務或 gRPC 服務；
• 執行 wire 生成依賴注入代碼；
• 運行代碼。