message?Foo?{
?? // ?
??extensions?100?to?199;
}

extend?Foo?{
??optional?int32?bar?=?126;
}

Foo?foo;
foo.SetExtension(bar,15);

message?Baz?{
??extend?Foo?{
????optional?int32?bar?=?126 ;
??}
??
}

Foo?foo;
foo.SetExtension(Baz::bar,?15);

message?Baz?{
??extend?Foo?{
????optional?Baz?foo_ext?=?127 ;
??}
??
}

message?Baz?{
??
}
//?This?can?even?be?in?a?different?file.
extend?Foo?{
??optional?Baz?foo_baz_ext?=?127 ;
}

message?Foo?{
??extensions?1000?to?max ;
}
max?is?229?-?1,?or?536,870,911.

package?foo.bar ;
message?Open?{?
?
}

message?Foo?{
??
??required?foo.bar.Open?open?=?1 ;
??
}

C++ ? ? ?生成的classes是用C++的namespace來區(qū)分的。舉例：Open?would?be?in?the?namespace?foo::bar。
Java ? ? ?package用于Java的package，除非你單獨(dú)的指定一個(gè)option?java_package?在.proto文件中。
Python ? package是被忽略的，因?yàn)镻ython的modules是通過它們的文件位置來組織的。

//?This?file?relies?on?plugins?to?generate?service?code.
option?cc_generic_services?=?false ;
option?java_generic_services?=?false ;
option?py_generic_services?=?false ;

message?Foo?{
??option?message_set_wire_format?=?true ;
??extensions?4?to?max ;
}

repeated?int32?samples?=?4? [ packed=true ] ;

optional?int32?old_field?=?6? [ deprecated=true ] ;

import?"google/protobuf/descriptor.proto" ;
extend?google.protobuf.MessageOptions?{
??optional?string?my_option?=?51234 ;
}
message?MyMessage?{
??option?(my_option)?=?"Hello?world!" ;
}

string ?value?=?MyMessage::descriptor()->options().GetExtension(my_option);

String?value?=?MyProtoFile.MyMessage.getDescriptor().getOptions().getExtension(MyProtoFile.myOption);

import?"google/protobuf/descriptor.proto" ;
extend?google.protobuf.FileOptions?{
??optional?string?my_file_option?=?50000 ;
}
extend?google.protobuf.MessageOptions?{
??optional?int32?my_message_option?=?50001 ;
}
extend?google.protobuf.FieldOptions?{
??optional?float?my_field_option?=?50002 ;
}
extend?google.protobuf.EnumOptions?{
??optional?bool?my_enum_option?=?50003 ;
}
extend?google.protobuf.EnumValueOptions?{
??optional?uint32?my_enum_value_option?=?50004 ;
}
extend?google.protobuf.ServiceOptions?{
??optional?MyEnum?my_service_option?=?50005 ;
}
extend?google.protobuf.MethodOptions?{
??optional?MyMessage?my_method_option?=?50006 ;
}
option?(my_file_option)?=?"Hello?world!" ;
message?MyMessage?{
??option?(my_message_option)?=?1234 ;
??optional?int32?foo?=?1? [ (my_field_option)?=?4.5 ] ;
??optional?string?bar?=?2 ;
}
enum?MyEnum?{
??option?(my_enum_option)?=?true ;
??FOO?=?1? [ (my_enum_value_option)?=?321 ] ;
??BAR?=?2 ;
}
message?RequestType?{}
message?ResponseType?{}
service?MyService?{
??option?(my_service_option)?=?FOO ;
??rpc?MyMethod(RequestType)?returns(ResponseType)?{
????//?Note:??my_method_option?has?type?MyMessage.??We?can?set?each?field
????//???within?it?using?a?separate? " option " ?line.
????option?(my_method_option).foo?=?567 ;
????option?(my_method_option).bar?=?"Some?string" ;
??}
}

//?foo.proto
import?"google/protobuf/descriptor.proto" ;
package?foo ;
extend?google.protobuf.MessageOptions?{
??optional?string?my_option?=?51234 ;
}
//?bar.proto
import?"foo.proto" ;
package?bar ;
message?MyMessage?{
??option?(foo.my_option)?=?"Hello?world!" ;
}

message?FooOptions?{
??optional?int32?opt1?=?1 ;
??optional?string?opt2?=?2 ;
}
extend?google.protobuf.FieldOptions?{
??optional?FooOptions?foo_options?=?1234 ;
}
//?usage:
message?Bar?{
??optional?int32?a?=?1? [ (foo_options.opt1)?=?123,?(foo_options.opt2)?=?"baz" ] ;
? ?//?alternative?aggregate?syntax?(uses?TextFormat):
??optional?int32?b?=?2? [ (foo_options)?=?{?opt1:?123?opt2:?"baz"?} ] ;
}

protoc?--proto_path=IMPORT_PATH?--cpp_out=DST_DIR?--java_out=DST_DIR?--python_out=DST_DIR?path/to/file.proto

如果一個(gè)message 不再滿足所有需要，需要對字段進(jìn)行調(diào)整.(舉例:對message增加一個(gè)額外的字段，但是仍然有支持舊格式message的代碼在運(yùn)行)

要注意以下幾點(diǎn):
1、不要修改已經(jīng)存在字段的數(shù)字順序標(biāo)示

2、可以增加optional或者repeated的新字段。這么做以后，所有通過舊格式message序列化的數(shù)據(jù)都可以通過新代碼來生成對應(yīng)的對象，正如他們不會丟失任何required元素。

你應(yīng)該為這些元素添加合理的默認(rèn)值，以便新代碼可以與舊代碼生成的消息交互。 新代碼創(chuàng)建的消息中舊代碼不存在的字段，在解析的時(shí)候，舊代碼會忽略掉新增的字段。

無論如何，未知的field不會被丟棄，如果message晚點(diǎn)序列化，為。

注意 未知field對于Python來說當(dāng)前不可用。

3、非required字段都可以轉(zhuǎn)為extension ，反之亦然，只要type和number保持不變。

4、int32, uint32, int64, uint64, and bool 是全兼容的。這意味著你能改變一個(gè)field從這些類型中的一個(gè)改變?yōu)榱硪粋€(gè)，而不用考慮會打破向前、向后兼容性。

如果一個(gè)數(shù)字是通過網(wǎng)絡(luò)傳輸而來的相應(yīng)類型轉(zhuǎn)換，你將會遇到type在C++中遇到的問題（e.g. if a 64-bit number is read as an int32, it will be truncated to 32 bits） ? ? ?

5、sint32 and sint64 彼此兼容,但是不能兼容其它integer類型.

6、string and bytes 在UTF-8編碼下是兼容的.?

7、如果bytes包含一個(gè)message的編碼,內(nèi)嵌message與bytes兼容.

8、fixed32 兼容 sfixed32, ?fixed64 兼容 sfixed64.

9、optional 兼容 repeated. 用一個(gè)repeat字段的編碼結(jié)果作為輸入,認(rèn)為這個(gè)字段是可選擇的客戶端會這樣處理,如果是原始類型的話,獲得最后的輸入作為相應(yīng)的option值;如果是message 類型,合并所有輸入元素.?

10、更改默認(rèn)值通常是OK的.要記得默認(rèn)值并不會通過網(wǎng)絡(luò)發(fā)送,如果一個(gè)程序接受一個(gè)特定字段沒有設(shè)置值的消息,應(yīng)用將會使用自己的版本協(xié)議定義的默認(rèn)值,不會看見發(fā)送者的默認(rèn)值.?