Windows 上配置 Go 的 gRPC 编译环境
1、Windows 上查看环境变量方法
以查看 GOPATH 为例。
- 普通命令行查看 GOPATH:
| echo %GOPATH% |
|---|
- PowerShell 上查看 GOPATH:
| echo $env:GOROOT |
|---|
2、安装 protoc
上 https://github.com/google/protobuf/releases 下载 protoc。以 protoc-3.13.0-win64.zip 为例,解压后将 bin 所在的完整目录(如“C:\Program Files\protoc-3.13.0-win64\bin”)加入到系统环境变量 PATH 中,目的是能找到 bin 目录中的 protoc 。
注意 protoc 并不包含 Go 版本的 proto 文件编译器插件,需要另外安装。此外,Go 版本的 gRPC 依赖的 protoc 的版本不能低于 3.0。
3、安装 gRPC
进入 GOROOT 或 GOPATH 的 src\google.golang.org 目录(以 GOROOT 为例,比如“C:\Go\src”),执行:
| git clone https://github.com/grpc/grpc-go |
|---|
成功后将 grpc-go 文件夹重命名为 grpc,完整路径如下:
| C:\$GOROOT\src\google.golang.org\grpc |
|---|
如果是 GOPATH 下的,则为:
| C:\$GOPATH\src\google.golang.org\grpc |
|---|
4、安装 genproto
同样在 src\google.golang.org 目录下,执行:
| git clone https://github.com/google/go-genproto |
|---|
成功后将 go-genproto 重命名为 genproto,完整路径如下:
| C:\$GOROOT\src\google.golang.org\genproto |
|---|
如果是 GOPATH 下的,则为:
| C:\$GOPATH\src\google.golang.org\genproto |
|---|
5、设置 Go 代理环境
| go env -w GOPROXY=https://goproxy.cn,direct |
|---|
如果不设置,则会因为网络不通在执行“go get”时失败,错误信息:
| A connection attempt failed because the connected party did not properly respond after a period of time, or established connection failed because connected host has failed to respond. |
|---|
6、安装 proto
| go get -u github.com/golang/protobuf/proto |
|---|
7、安装编译插件 protoc-gen-go
protoc-gen-go 是 Go 版本的 proto 文件编译器插件,安装方法:
| go get -u github.com/golang/protobuf/protoc-gen-go |
|---|
成功后,可在目录 $GOPATH/bin 下看到 protoc-gen-go.exe。
需将 $GOPATH/bin 加入到系统环境变量 PATH 中,否则执行 protoc 编译时将报如下这样的错误:
| 'protoc-gen-go' 不是内部或外部命令,也不是可运行的程序或批处理文件。 --go_out: protoc-gen-go: Plugin failed with status code 1. |
|---|
8、下载依赖包
创建目录 C:$GOROOT\src\golang.org\x,然后进入 x 目录,执行以下两步操作:
| git clone https://github.com/golang/net.git git clone https://github.com/golang/text.git |
|---|
9、测试验证
切换到目录(依赖 gRPC 安装在目录 GOROOT 还是目录 GOPATH):
| C:\$GOROOT\src\google.golang.org\grpc\examples\helloworld |
|---|
或(如果 gRPC 安装在目录 GOPATH)
| C:\$GOPATH\src\google.golang.org\grpc\examples\helloworld |
|---|
编译子目录 helloworld 下的 helloworld.proto 生成 Go 代码文件 helloworld.pb.go:
| protoc -I .\helloworld helloworld.proto --go_out=plugins=grpc:"c:\go\src" |
|---|
上面的“-I”用于指定 proto 文件所在目录。如果没有报错,则可在子目录 helloworld 下找到编译生成的文件 helloworld.pb.go,编译环境即已搭建好。
注意“plugins=grpc:”后的值受“.proto”文件中的 go_package 值影响,两者共同组成生成的“.pb.go”文件所在目录。如果“.proto”文件中没有指定 go_package,则只受“plugins=grpc:”后的值的影响。
浙公网安备 33010602011771号