windows 下 goprotobuf 的安装与使用

安装 protoc

  • 下载 protoc-3.11.2-win64.zip 压缩包
    • https://github.com/protocolbuffers/protobuf/releases
  • 将文件解压到某一文件夹。 如:C:\soft\protoc
  • 【windows 下 goprotobuf 的安装与使用】将解压出来的文件夹下的 C:\soft\protoc\bin 目录配置到 PATH 环境变量下

安装protobuf的编译器protoc-参考
window:
  • 下载: protoc-3.3.0-win32.zip
  • 解压,把bin目录下的protoc.exe复制到GOPATH/bin下,GOPATH/bin加入环境变量。
  • 当然也可放在其他目录,需加入环境变量,能让系统找到protoc.exe
    linux:
  • 下载:protoc-3.3.0-linux-x86_64.zip 或 protoc-3.3.0-linux-x86_32.zip
  • 解压,把bin目录下的protoc复制到GOPATH/bin下,GOPATH/bin加入环境变量。
  • 如果喜欢编译安装的,也可下载源码自行安装,最后将可执行文件加入环境变量。

安装 protoc-gen-go
  • 在终端直接执行 go get -u github.com/golang/protobuf/protoc-gen-go,可以在你的%GOPATH%/bin路径下找到一个 protoc-gen-go.exe
  • 如: $GOPATH=C:\Users\answer\go\


common.ptoto
syntax = "proto3"; message Response { // 状态编码 int32 code = 1; // 状态编码具体错误描述 string message = 2; // 返回数据 bytes result = 3; }

# 进入对应的目录执行以下命令生成 common.ptoto.pb.go 文件 protoc.exe--go_out=./common.ptoto# 或使用以下命令 protoc --plugin=protoc-gen-go=C:\Users\answer\go\bin\protoc-gen-go.exe --go_out=./ common.proto


错误分析
# 执行 protoc.exe--go_out=./common.ptoto 报错, 错误描述 --go_out: protoc-gen-go: Plugin failed with status code 1.# 解决方案 go get -u github.com/golang/protobuf/protoc-gen-go


undefined: proto.ProtoPackageIsVersion3
undefined: proto.ProtoPackageIsVersion3# 通过 go get -u google.golang.org/grpc 安装的 protoc-gen-go版本永远是最新的(支持v3) # 而使用grpc教程 demo 用的包是 protoc-gen-go v1.2.0 版本 (不支持v3 )GIT_TAG="v1.2.0" # change as needed go get -d -u github.com/golang/protobuf/protoc-gen-go # 切换到 1.2.0 分支 git -C "$(go env GOPATH)"/src/github.com/golang/protobuf checkout $GIT_TAG go install github.com/golang/protobuf/protoc-gen-go


undefined: proto.InternalMessageInfo
undefined: proto.InternalMessageInfo# 原因: 新的版本加入了InternalMessageInfo导致编译不过# 解决方案1、 # 1. 使用旧版本的插件,即手动下载并安装protoc-gen-go版本v1.1.0 (https://github.com/golang/protobuf/releases/tag/v1.2.0)来生成旧风格的原型代码。 # 下载文件 https://github.com/golang/protobuf/archive/v1.2.0.zip # 解压, tar包方式: tar zxvf protobuf-1.2.0.tar.gz# 进入到源码的 protoc-gen-go 目录 cd protobuf-1.2.0/protoc-gen-go # 重新编译 go build# 将生成的protoc-gen-go放入$GOROOT/bin目录下,重新编译protobuf文件protoc xxx.proto --go_out=.# 重新编译项目,问题解决# C:\Users\answer\go\src\github.com\golang\protobuf$GOPATH\src\github.com\golang\protobuf # 解决方案2 # 1. 使用正确的依赖版本:您的项目依赖项中应该有github.com/golang/protobuf 目录,# 2. 将其替换为最新版本(v1.2.0),下载地址:https://github.com/golang/protobuf/releases,# 3. 即将下载的目录替换项目中的github.com/golang/protobuf目录,问题解决。# 删除生成的 ***.ptoto.pb.go 文件中的 XXX*** 字段和方法


使用maven生成
  • 步骤1: Idea 下载 Protobuf Support 插件
  • 步骤2: 配置pom文件
org.xolstice.maven.plugins protobuf-maven-plugin 0.5.0 ${basedir}/src/main/proto com.google.protobuf:protoc:3.0.0:exe:${os.detected.classifier} grpc-java io.grpc:protoc-gen-grpc-java:${grpc.version}:exe:${os.detected.classifier}${project.basedir}/src/main/javafalse compilecompile-custom

不指定路径的话,默认生成java文件路径: target\generated-sources\protobuf\java
  • 步骤3:
    • 方式1: Idea右边栏Maven->Plugins->protobuf->protobuf:compile 双击执行
    • 方式2: 进入pom.xml文件目录下执行: mvn clean protobuf:compile
方式2如果执行失败: 先执行mvn install:install-file -DgroupId=com.google.protobuf -DartifactId=protoc -Dversion=3.0.0 -Dclassifier=windows-x86_64} -Dpackaging=exe -Dfile=C:\soft\protoc\bin\protoc.exe再执行方式2。

Reference
  • jaemon-go GitHub 源码

    推荐阅读