（二） Kratos 框架快速开始：CLI工具

一. 安装
三种安装方式任选其一：

• go get 安装

  go get -u github.com/go-kratos/kratos/cmd/kratos/v2@latest

  

• go install 安装

  go install github.com/go-kratos/kratos/cmd/kratos/v2
  # go 1.16版本以上需要指定版本号或使用最新版
  go install github.com/go-kratos/kratos/cmd/kratos/v2@latest

  

• 源码编译安装

  git clone https://github.com/go-kratos/kratos
  cd kratos
  make install

二. 创建项目
通过 kratos 命令创建项目模板：

kratos new helloworld（项目名称）

使用 -r 指定源

# 国内拉取失败可使用gitee源
kratos new helloworld -r https://gitee.com/go-kratos/kratos-layout.git
# 亦可使用自定义的模板
kratos new helloworld -r xxx-layout.git
# 同时也可以通过环境变量指定源
KRATOS_LAYOUT_REPO=xxx-layout.git
kratos new helloworld

使用 ​-b​ 指定分支

kratos new helloworld -b main

三.添加 Proto 文件

kratos-layout 项目中对 proto 文件进行了版本划分，放在了 v1 子目录下

kratos proto add api/helloworld/demo.proto

输出:

api/helloworld/demo.proto

四.生成 Proto 代码

# 可以直接通过 make 命令生成
make api

# 或使用 kratos cli 进行生成
kratos proto client api/helloworld/demo.proto

会在proto文件同目录下生成:

api/helloworld/demo.pb.go
api/helloworld/demo_grpc.pb.go
# 注意 http 代码只会在 proto 文件中声明了 http 时才会生成（如下图所示）
api/helloworld/demo_http.pb.go

五.生成 Service 代码
通过 proto文件，可以直接生成对应的 Service 实现代码：

使用 ​-t​ 指定生成目录

kratos proto server api/helloworld/demo.proto -t internal/service

输出:

internal/service/demo.go

六. 运行项目
如子目录下有多个项目则出现选择菜单

kratos run 

七.查看版本

kratos -v

八.工具升级

kratos upgrade

九.更新日志

# 等同于打印 https://github.com/go-kratos/kratos/releases/latest 的版本更新日志
kratos changelog

# 打印指定版本更新日志
kratos changelog v2.1.4

# 查看自上次版本发布后的更新日志
kratos changelog dev

十.查看帮助

kratos -h
kratos new -h