Go语言---linux下安装golang protoc详细教程以及完整安装protoc-gen-go工具

news2024/12/22 20:32:35

在[分布式网络通讯框架]----Protobuf安装配置–附带每一步截图中，我们详细介绍了Protobuf是什么，为什么要使用Protobuf，以及在linux环境中，如何安装Protobuf。Protobuf 在 .proto 定义需要处理的结构化数据，可以通过 protoc 工具，将 .proto 文件转换为 C、C++、Golang、Java、Python 等多种语言的代码，兼容性好，易于使用。现在在学习Go语言的过程中，也需要使用Protobuf，所以在安装Protobuf的基础上，在继续安装Go语言环境下使用Protobuf的必要步骤，即protoc-gen-go 的安装。

1.检查protoc是否安装

protoc --version
在这里插入图片描述

2.将安装好的文件夹移动到/usr/local

cp /protobuf /usr/local
在这里插入图片描述

3.拉取环境

在 Golang 中使用 protobuf，还需要安装 protoc-gen-go，这个工具用来将 .proto 文件转换为 Golang 代码。

go install google.golang.org/protobuf/cmd/protoc-gen-go@latest

4.写一个`.proto`文件

syntax = "proto3";

package geecachepb;

message Request {
  string group = 1;
  string key = 2;
}

message Response {
  bytes value = 1;
}

service GroupCache {
  rpc Get(Request) returns (Response);
}

这时候进行编译 `protoc --go_out=. *.proto` 会报错

在这里插入图片描述

说明当前路径没有在环境变量中，需要进行如下配置：

5.配置环境变量

protoc-gen-go 将自动安装到 $GOPATH/bin 目录下，也需要将这个目录加入到环境变量中。Go的安装教程在另一篇博客中，相关环境变量的配置也在其中Go语言—Linux安装Golang环境以及VScode远程搭建环境
在这里插入图片描述

6.进入`vim ~/.bashrc`

在文件下方

xport GOPATH=/home/go
export GOROOT=/usr/local/go
export PATH=$PATH:$GOROOT/bin:$GOPATH/bin

在这里插入图片描述

保存并使其生效source ~/.bashrc

7.进入`/etc/profile`

在下方添加如下配置：

export PROTOBUF=/home/go
export GOROOT=/usr/local/go
export GOPATH=/home/go
export PATH=$PATH:$GOROOT/bin:$GOPATH/bin:$PROTOBUF/bin/linux_amd64

其中新添加的是第一句和最后PATH中的PROTPBUF环境变量，

在这里插入图片描述

这里的路径要和自己实际的路径相匹配，我的路径如上配置以及相关文件位置如第五步图中所示
保存并使其生效source /etc/profile

8. 打开新的命令行，进入`.proto`文件所在的文件夹，再次执行 `protoc --go_out=. *.proto` 如果报错如下：

protoc-gen-go: unable to determine Go import path for "geecachepb.proto"
Please specify either:
        • a "go_package" option in the .proto source file, or
        • a "M" argument on the command line.
See https://developers.google.com/protocol-buffers/docs/reference/go-generated#package for more information.
--go_out: protoc-gen-go: Plugin failed with status code 1.

原因是找不到该文件编译出来的golang文件的导出目录。
进入.proto文件，添加如下语句：

option go_package="./";

整体代码如下：

syntax = "proto3";

package geecachepb;

option go_package="./";

message Request {
  string group = 1;
  string key = 2;
}

message Response {
  bytes value = 1;
}

service GroupCache {
  rpc Get(Request) returns (Response);
}