1、说明

本文简单介绍入门级使用 Proto 文件的一些基础语法

示例中的proto文件描述了一个数据结构，遵循 Protobuf 语法

示例：

message TestOne {
	required string name = 1;
	optional int32 age = 2;
}

2、字段类型

1. 负数使用 sint ；
2. 数值较大，使用 fixed ；

3、字段规则

示例中的 required 和 optional 都是字段规则，规则有以下几个：

optional 字段是可选字段，如果不设定数据，则需要有一个默认值以避免出错，指定方式：

message TestOne {
	required string name = 1;
	optional int32 age = 2 [default = 100];
}

4、字段编号

如示例中，每个字段都有一个编号，这些编号是 唯一的。

• 编号1-15会占用一个字节，16-2047占用两个字节，因此尽可能使用1-15；

• 字段编号在 message 被使用后，就不能再更改；

5、注释

支持使用 C/C++ 风格的注释

6、类型

6.1、message

• message 表示一个类型，后面的名称将会是类名；
• 一个proto文件可以定义多种 message 类型，但尽可能减少一个proto多类型的情况；

组合 messages 会导致膨胀虽然可以在单个 .proto 文件中定义多种 messages 类型（例如 message，enum 和 service），但是当在单个文件中定义了大量具有不同依赖关系的 messages 时，它也会导致依赖性膨胀。建议每个 .proto 文件包含尽可能少的 message 类型。

6.2、service

一般在和RPC系统一起使用，示例：

service SearchService {
	rpc Search (SearchRequest) returns (SearchResponse);
}

7、枚举enum

枚举定在 message 内部

示例：

message TestOne {
	required string name = 1;
	optional int32 age = 2 [default = 100];
	
	enum Country {
		China = 0;
		USA = 1;
	}
	optional Country country = 3 [default = China]
}

8、保留字段

示例：

下面例子，字段编号2/15/9/11曾经使用过，保留；字段名 foo/bar 曾经使用过，保留

message Foo {
    reserved 2, 15, 9 to 11;
	reserved "foo", "bar";
}

如果一个字段不再需要，如果删除或者注释掉，则其他人在修改时会再次使用这些字段编号，那么旧的引用程序就可能出现一些错误，所以使用保留字段，保留已弃用的字段编号或字段名 ，可解决该问题

9、import

如果一个 proto 文件需要使用另一个 proto 文件中的定义(message/service)，就需要使用 import 引入其他的 proto 文件

import 使用 public 属性，控制依赖是否可以传递，被 public 修饰的可以传递

示例：

//second.proto
import "message/aaa.proto";
import public "message/bbb.proto";

//test_one.proto
import "message/second.proto";

message TestOne {
	required string name = 1;
	optional int32 age = 2 [default = 100];
}

如上示例中，test_one.proto 中可以使用 bbb.proto 的类型，但不能使用 aaa.proto 中的类型

9.1、protoc指令

protoc 的参数 -I 和 --proto_path 用于传递 import 的路径

当不同的 proto 文件位于不同的路径时，import 可以不传递相对路径，而使用 -I 或者 --proto_path 传递 import 的查找路径