1. 安装Go

1.1 下载Go

wget https://studygolang.com/dl/golang/go1.13.4.linux-amd64.tar.gz
# 解压
tar -zxvf go1.13.4.linux-amd64.tar.gz

1.2 配置go环境

编辑 /etc/profile 文件

vim ~/.bashrc

将下面内容加入到末尾（GOPAT是我Windows中的GOPATH）

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

2. 工具安装

2.1 安装protoc

去这个网址下载：https://github.com/protocolbuffers/protobuf/releases，根据自己的系统，下载对应的文件
解压：

unzip protoc.zip 

将bin文件夹下的 protoc 复制到Linux 中的 /bin目录下

sudo cp protoc/bin/protoc /bin/protoc

执行 protoc -verson 如果输出版本信息则证明配置成功

2.2 安装protoc-gen-go

# 下载
git clone https://github.com/golang/protobuf.git
# 进入目录
cd protobuf/protoc-gen-go
# 编译
go install

2.3 安装protoc-gen-validate

这个是用来生成pb的校验规则文件，也就是*.pb.validate.go

go get -u github.com/envoyproxy/protoc-gen-validate

2.4 安装protoc-gen-doc

这个是用来生成 proto 的文档文件，会生成一个 html 格式的文档， 下载地址：https://github.com/pseudomuto/protoc-gen-d...

wget https://github.com/pseudomuto/protoc-gen-doc/releases/download/v1.3.0/protoc-gen-doc-1.3.0.windows-amd64.go1.11.2.tar.gz
# 解压
tar -zxvf protoc-gen-doc-1.3.0.windows-amd64.go1.11.2.tar.gz

2.5 安装proto-gen-java

可在这个地址下载 protoc-gen-java工具，https://repo1.maven.org/maven2/io/grpc/pro... ，记得把文件名改为protoc-gen-grpc-java

3. 编译

3.1 hello.proto

syntax="proto3";

package main;

message Hello {
    string value = 1;
}

3.2 编译

3.2.1 编译为Go代码（protoc-gen-go)

protoc --go_out=plugins=grpc,paths=source_relative:. --validate_out="lang=go,paths=source_relative:." hello.proto

注意

• paths参数
  使用 source_relative 则不会使用option go_package中指定的路径
  使用 import 则是使用option go_package 中指定的路径

3.2.2 编译为Java代码 (protoc-gen-java)

可在这个地址下载 protoc-gen-java工具，https://repo1.maven.org/maven2/io/grpc/pro... ，记得把文件名改为protoc-gen-grpc-java

protoc --java_out=. --grpc-java_out=. hello.proto

3.2.3 生成proto文档(proto-gen-doc)

protoc --doc_out=. --doc_opt=html,index.html:Ignore* hello.proto user.proto

3.3 复杂点的proto

syntax="proto3";

//生成的pb文件中package为admin
package admin;

//生成go文件的路径
option go_package          = "pb/admin";
//关闭Java多文件
option java_multiple_files = false;
//生成的Java文件的package路径
option java_package        = "pb.admin";

service UserService {
    rpc Login(LoginReq) returns (LoginResp);
}

message LoginReq {
    string username = 1;
    string password = 2;
}

message LoginResp {
    int32 code = 1;
    string msg = 2;
}

3.4 编译脚本

#!/usr/bin/env bash

TARGET="../"

if [ -n "$1" ]; then
    TARGET=$1
fi

# 排除掉 extra/src 目录
for file in `find . -path ./extra/src -prune -o -name '*.proto' -print`;
do
    echo $file
    protoc -I=extra/src:. --go_out=plugins=grpc,paths=import:$TARGET --validate_out="lang=go,paths=import:$TARGET" $file
done

欢迎关注我微信公众号，一起来学习Go语言

本作品采用《CC 协议》，转载必须注明作者和本文链接