RPC 系列（二）：Go gRPC 环境安装

gRPC

发布日期: 2023-09-12

作者: 吴杭沉

文章字数: 574

阅读时长: 2 分

阅读次数:

在开始编写 gRPC 应用之前，需要先安装 protoc 编译器以及 Go 语言相关的依赖包。本篇介绍环境搭建的完整过程。

安装 protoc

根据自身电脑的操作系统，选择 protoc 最新的 releases 版本下载。

protoc 的 releases 下载列表，包含各平台的安装包，图中选中 protoc-3.11.4-win64.zip

解压后在 bin 目录找到 protoc.exe，然后把它复制到 GOBIN 目录下。

提示：一般操作是把 protoc.exe 所在的目录配到环境变量里，这里直接把 protoc.exe 复制到 GOBIN 目录下，前提是环境变量已经配置了 GOBIN 环境变量。

打开 cmd，运行 protoc --version，成功打印当前版本信息证明安装成功了。

安装相关包

安装 golang 的 proto 工具包：

go get -u github.com/golang/protobuf/proto

安装 golang 的 proto 编译支持：

go get -u github.com/golang/protobuf/protoc-gen-go

安装 gRPC 包：

go get -u google.golang.org/grpc

创建并编译 proto 文件

新建 proto 文件夹，在里面新建 simple.proto 文件：

syntax = "proto3"; // 协议为proto3

package proto;

// 定义发送请求信息
message SimpleRequest{
    // 定义发送的参数
    // 参数类型 参数名 标识号(不可重复)
    string data = 1;
}

// 定义响应信息
message SimpleResponse{
    // 定义接收的参数
    // 参数类型 参数名 标识号(不可重复)
    int32 code = 1;
    string value = 2;
}

// 定义我们的服务（可定义多个服务,每个服务可定义多个接口）
service Simple{
    rpc Route (SimpleRequest) returns (SimpleResponse){};
}

编译 proto 文件

cmd 进入 simple.proto 所在目录，运行以下指令进行编译：

protoc --go_out=plugins=grpc:./ ./simple.proto

VSCode-proto3 插件介绍

如果使用 VSCode，可以安装 vscode-proto3 插件，方便编辑和编译 proto 文件。插件的配置如下：

// vscode-proto3插件配置
"protoc": {
    // protoc.exe所在目录
    "path": "C:\\Go\\bin\\protoc.exe",
    // 保存时自动编译
    "compile_on_save": true,
    "options": [
        // go编译输出指令
        "--go_out=plugins=grpc:."
    ]
}