Goctl安装

goctl是go-zero框架下的代码生成工具。其功能有:

  • api服务生成
  • rpc服务生成
  • model代码生成
  • 模板管理

go get 安装goctl

1
2
3
4
5
# Go 1.15 及之前版本
GO111MODULE=on GOPROXY=https://goproxy.cn/,direct go get -u github.com/zeromicro/go-zero/tools/goctl@latest

# Go 1.16 及以后版本
GOPROXY=https://goproxy.cn/,direct go install github.com/zeromicro/go-zero/tools/goctl@latest

通过此方式安装,会自动安装在$GOPATH/bin,如果忘了自己的$GOPATH在什么地方,可以通过

1
go env

查找到对应的目录。

添加到环境参数

若原先设定过$GOPATH,应该是不需要这一步。由于我是通过pacman安装的Go,因此没有设定过。

以我本人所用的zsh终端举例,使用任意文本编辑工具(vim、vi)打开~/.zshrc,添加如下一行

1
export PATH=$PATH:~/go/bin

在添加好环境变量后,可以通过如下指令测试

1
goctl -v

如果正常显示出,则表示安装成功。

protoc & protoc-gen-go 安装

protoc是一款用C++编写的工具,其可以将proto文件翻译为指定语言的代码。在go-zero的微服务中,我们采用grpc进行服务间的通信,而grpc的编写就需要用到protoc和翻译成go语言rpc stub代码的插件protoc-gen-go。

一般情况下,我们都是通过goctl进行一键安装

1
goctl env check -i -f --verbose

这样我们就同时安装上protoc & protoc-gen-go了!

其他环境

除了go-zero本身相关的开发工具,我们还要安装一些的环境

  • etcd
  • redis
  • mysql