golang 安装 protoc

2023-05-21 16:05:03 安装 Golang protoc

作为一种开放源代码的编程语言golang 的使用场景越来越广泛,而 Golang 编写的程序需要和其他的程序进行交互,其中很多应用都会使用 Protocol Buffers 作为它们之间的通信格式。Protocol Buffers 是由 Google 开发的一种数据序列化的协议,它可以将复杂的数据结构用二进制格式进行高效的编码和解码。

而要使用 Protocol Buffers,我们需要安装 proto compiler(protoc),它是 Protocol Buffers 的编译器,用来将 .proto 文件编译成各种程序语言的源文件,包括 Golang。如何在 Golang 中使用 Protocol Buffers 以及如何安装 protoc,本文将详细介绍。

安装 protoc

从源代码安装 protoc

linux 系统上,我们可以从 GitHub 上下载 protoc 的源代码,然后使用以下命令进行编译安装:

$ git clone https://github.com/google/protobuf
$ cd protobuf
$ ./autogen.sh && ./configure && make && sudo make install

Mac OS 上,我们可以使用 Homebrew 来安装 protoc:

$ brew install protobuf

使用预编译的二进制文件

我们还可以从 Protocol Buffers 的官方网站上下载预编译的二进制文件,这样就可以跳过编译 protoc 的步骤,直接开始使用:

  1. 访问 [Protocol Buffers 官方网站](Https://github.com/protocolbuffers/protobuf/releases)。
  2. 根据你的操作系统和处理器架构选择对应的版本,下载 protoc-X.X.X-OS-ARCH.zip
  3. 解压缩文件并将 bin/protoc 添加到系统路径中:export PATH=$PATH:/path/to/protoc/bin

在 Golang 中使用 Protocol Buffers

安装好了 protoc 之后,接下来就要在 Golang 中使用了。对于 Golang,要使用 Protocol Buffers 有两种方式:

  1. 手写 Protocol Buffers 描述文件,然后根据这个描述文件生成 Go 代码;
  2. 使用 protobuf 工具生成 Golang 代码,并在项目中使用这些生成的代码。

手写 Protocol Buffers 描述文件并生成 Go 代码

编写 .proto 文件

在使用 Protocol Buffers 之前,我们需要编写一个 .proto 文件,用来描述数据结构和消息的格式。下面是一个简单的例子:

syntax = "proto3";

package greet;

message HelloRequest {
  string name = 1;
}

message HelloReply {
  string message = 1;
}
  • syntax = "proto3"; 表示我们使用的是 Protocol Buffers 的第三个版本。
  • package greet;grpc 所须的 package 名称。
  • message 是消息的定义,其中包含的字段名称和类型。
  • string name = 1; 表示该字段的数据类型是字符串,字段名称是 name,字段编号为 1。

使用 protoc 编译生成 Go 代码

在编写好 .proto 文件后,我们可以使用 protoc 编译器,生成 Go 代码。使用以下命令生成 Go 代码:

$ protoc --go_out=. *.proto

这个命令会将当前目录下所有的 .proto 文件编译成 Go 代码,并生成在当前目录。

使用 protobuf 工具生成 Golang 代码

我们还可以利用 protobuf 工具生成 Golang 代码,protobuf 工具是官方提供的一个命令行工具,它可以根据 .proto 文件,自动为我们生成各种编程语言的代码。

安装 protobuf 工具

在命令行中执行以下命令安装 protobuf 工具:

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

编写 .proto 文件

同样,我们也需要编写一个 .proto 文件,来描述数据结构和消息的格式。这里同样采用上面的例子。

根据 .proto 文件生成 Golang 代码

使用以下命令来生成 Golang 代码:

$ protoc --go_out=. --go-grpc_out=. --go_opt=paths=source_relative *.proto

这个命令会根据你在 .proto 文件中定义的消息、服务和方法,生成对应的 Golang 代码。

我们已经介绍了如何在 Golang 中使用 Protocol Buffers,以及如何安装 protoc。通过在 Golang 中使用 Protocol Buffers 可以方便的实现不同进程之间数据传输,提升通信的效率。

以上就是golang 安装 protoc的详细内容,更多请关注其它相关文章!

相关文章