Ubuntu系统安装Protocol Buffers (protobuf) 编译器完全指南

2025/09/13技术杂谈6601886 字4 分钟

Protocol Buffers（简称protobuf）是Google开发的一种高效的数据序列化工具，广泛应用于RPC系统和数据存储等场景。本文将详细介绍在Ubuntu系统上安装protobuf编译器（protoc）的三种方法，并帮助您选择最适合的安装方式。

方法一：使用预编译的二进制文件（推荐）

这是最直接、最不容易出现依赖问题的安装方法，适合绝大多数用户。通过此方法，您可以轻松安装特定版本或最新版本的protoc编译器。

访问GitHub发布页面
打开Protocol Buffers的GitHub发布页面，查看最新稳定版本：
https://github.com/protocolbuffers/protobuf/releases

找到最新版本（例如v26.1），在"Assets"部分中，选择适用于Linux系统的protoc-*-linux-x86_64.zip文件（如protoc-26.1-linux-x86_64.zip）。
下载压缩包
使用curl或wget命令下载到您的服务器（请将链接中的版本号替换为您看到的最新版本）：
```
PB_REL="https://github.com/protocolbuffers/protobuf/releases/download/v26.1/protoc-26.1-linux-x86_64.zip"
curl -LO $PB_REL
```
解压到系统目录
将下载的压缩包解压到系统的/usr/local目录（这是推荐的安装位置）：
```
sudo unzip protoc-26.1-linux-x86_64.zip -d /usr/local
```
解压后，bin/protoc可执行文件和include/google头文件目录会分别被放置到/usr/local/bin和/usr/local/include目录中。
设置执行权限
确保protoc可执行文件拥有正确的执行权限：
```
sudo chmod +x /usr/local/bin/protoc
```
通常/usr/local/bin已经包含在系统的PATH环境变量中，因此您无需额外配置路径。
验证安装
运行以下命令检查安装是否成功：
```
protoc --version
```
如果安装成功，命令会输出类似libprotoc 26.1的版本信息。

Ubuntu的官方软件仓库提供了protobuf-compiler包，安装过程非常简单，但需要注意的是，仓库中的版本可能不是最新的。

更新软件包列表
```
sudo apt update
```
安装protobuf编译器
```
sudo apt install protobuf-compiler
```
验证安装
```
protoc --version
```
注意：通过此方法安装的版本通常较低（例如Ubuntu 22.04 LTS默认提供的是3.12.4版本）。如果您对protobuf版本有特定要求，建议使用方法一。

如果您需要自定义构建选项、获取绝对最新的代码，或者计划参与Protocol Buffers的开发，可以选择从源码编译安装。

安装构建依赖

sudo apt update
sudo apt install autoconf automake libtool curl make g++ unzip

克隆源码仓库

git clone https://github.com/protocolbuffers/protobuf.git
cd protobuf
git submodule update --init --recursive

生成配置脚本并编译

./autogen.sh
./configure
make
# 如需加速编译，可使用多线程：make -j$(nproc)

下表总结了三种安装方法的优缺点和适用场景，帮助您选择最适合的方案：

对于绝大多数用户，**强烈推荐使用方法一（预编译的二进制文件）**进行安装，因为它兼顾了安装简便性、版本可控性和系统环境的整洁性。这种方法可以让您快速获得最新且稳定的Protocol Buffers编译器，避免潜在的依赖冲突问题，为您的开发工作提供良好的支持。

暂无评论