首页/资讯中心/详情

protocol buffers(protobuf)安装教程

protocol buffers(protobuf)安装教程
📅 发布时间：2026/7/10 13:16:46

本文按照mac讲解protobuf的安装，windows上比较好安装按照mac的基本流程就可以安装成功，mac上的安装有的时候比较容易出现问题

一、通过brew的方式安装（仅Mac）

需要mac中存在brew，输入命令：brew --version查看是否存在brew，如不存在就进行安装，安装方法直接百度即可。

1.安装protobuf命令：brew install protobuf

安装指定版本的protobuf命令：brew install protobuf@3.7

2.查看是否安装成功命令：protoc --version

user@C02FP58GML7H bin % protoc--versionlibprotoc3.20.1

3.卸载protobuf命令：brew uninstall protobuf

4.brew安装安装路径

  • 配置文件在：/usr/local/etc下
  • 安装文件在：/usr/local/Cellar下
  • 二进制可执行程序的软连接在：/usr/local/bin下

注意：一般情况通过brew install安装应用最先是放在/usr/local/Cellar/目录下，有些应用会自动创建软链接放在/usr/bin或者/usr/sbin，同时也会将整个文件夹放在/usr/local，忘记的时候或者找不到的时候，可以使用brew list软件名确定安装位置

二、源码编译方式安装（Mac、Linux）

1.从官方仓库地址下载protobuf-all-21.6.tar.gz(当前最新版)

2.解压到目的目录下：tar -zxvf protobuf-all-21.6.tar.gz

3.进入到解压后的源码目录下：cd protobuf-all-21.6

4.检测安装环境是否满足条件，生成Makefile：./configure --prefix=/usr/local/protobuf

5.经典的编译安装步骤：make && make install

6.添加环境变量：（Linux需要按照linux的方式配置环境变量）

cd ~

export PROTOBUF=/usr/local/protobuf

export PATH=P R O T O B U F / b i n : PROTOBUF/bin:PROTOBUF/bin:PATH

vim .bash_profile

source .bash_profile

7.查看是否安装成功命令：protoc --version

三、压缩包解压方式安装（适合Mac、Windows、Linux）

1.从官方仓库地址下载

  • 适用Windows 64位：protoc-21.6-win64.zip
  • 适用Windows 32位：protoc-21.6-win32.zip
  • 适用Mac 英特尔Intel 64位：protoc-21.6-osx-x86_64.zip
  • 适用Mac ARM 64位：protoc-21.6-osx-aarch_64.zip
  • 适用Linux 64位：protoc-21.6-linux-x86_64.zip

2.解压到目的目录下

目录结构如下：

  • bin目录下的protoc是可执行文件
  • include目录下的是gogle定义的.protoc文件，我们使用的就是import "google/protobuf/timestamp.proto"
user@C02FP58GML7H protoc-3.20.1-osx-x86_64 % tree.├── bin │ └── protoc ├── include │ └── google │ └── protobuf │ ├── any.proto │ ├── api.proto │ ├── compiler │ │ └── plugin.proto │ ├── descriptor.proto │ ├── duration.proto │ ├── empty.proto │ ├── field_mask.proto │ ├── source_context.proto │ ├── struct.proto │ ├── timestamp.proto │ ├── type.proto │ └── wrappers.proto └── readme.txt ~/.bash_profile （一般在这个文件中添加用户级环境变量）

3.添加环境变量

Mac配置环境变量的地方：

  1. **/etc/profile（建议不修改这个文件）：**全局（公有）配置，不管是哪个用户，登录时都会读取该文件。
  2. **/etc/bashrc（一般在这个文件中添加系统级环境变量）：**全局（公有）配置，bash shell执行时，不管是何种方式，都会读取此文件。
  3. **~/.bash_profile（一般在这个文件中添加用户级环境变量）：**每个用户都可使用该文件输入专用于自己使用的shell信息，当用户登录时，该文件仅仅执行一次！
  4. **注意：**但有时在.bash_profile文件中的环境变量会无效

当mac中存在zsh，修改环境变量就要在**~/.zshrc**中修改，本教程就是在此文件中加入如下配置，=后面是文件加压后的路径，自行修改：

alias protoc=/Users/user/Desktop/workspace2/protoc-3.20.1-osx-x86_64/bin/protoc

刷新配置使修改立即生效，需要执行：

source ~/.zshrc

4.Linux中同理适用对应的修改添加环境变量的方法，然后刷新配置，修改方法百度即可

5.Windows中只需要在图形化的配置中加入环境变量即可，具体实现直接百度即可