背景：gogo/protobuf 的興衰

在 Go 生態(tài)系統(tǒng)中，gogo/protobuf 曾是官方 golang/protobuf 的強(qiáng)力替代方案，提供了許多增強(qiáng)功能。然而這個項(xiàng)目已在兩年前被標(biāo)記為廢棄（Deprecated），作者最終放棄了維護(hù)。

其中最讓作者和社區(qū)失望的，是官方 Protobuf 庫始終拒絕支持的一個關(guān)鍵功能——標(biāo)簽注入。這一功能正是許多開發(fā)者選擇 gogo/protobuf 的主要原因。

什么是標(biāo)簽注入功能？

標(biāo)簽注入允許開發(fā)者在 .proto 文件中直接定義生成 Go 結(jié)構(gòu)體時的字段標(biāo)簽（如 JSON tag）。這是 gogo/protobuf 擴(kuò)展的核心功能之一。

功能示例

考慮以下 Protobuf 定義：

messagePerson{
string name =1;
int32 id =2[(gogoproto.jsontag)="id"];// 自定義JSON標(biāo)簽
string email =3;

enumPhoneType{
    MOBILE =0;
    HOME =1;
    WORK =2;
}

messagePhoneNumber{
string number =1;
PhoneType type =2;
}

repeatedPhoneNumber phones =4;
google.protobuf.Timestamp last_updated =5;
}

使用 gogo/protobuf 生成的 Go 代碼：

type Person struct{
 Name        string`protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
 Id          int32`protobuf:"varint,2,opt,name=id,proto3" json:"id"`// 注意沒有omitempty
 Email       string`protobuf:"bytes,3,opt,name=email,proto3" json:"email,omitempty"`
 Phones      []*Person_PhoneNumber  `protobuf:"bytes,4,rep,name=phones,proto3" json:"phones,omitempty"`
 LastUpdated *timestamppb.Timestamp `protobuf:"bytes,5,opt,name=last_updated,json=lastUpdated,proto3" json:"last_updated,omitempty"`
}

可以看到 Id 字段的 JSON tag 被自定義為 "id"，并且移除了 omitempty 標(biāo)簽，這在某些 API 設(shè)計(jì)中非常有用。

官方為何拒絕支持？

盡管社區(qū)強(qiáng)烈要求，golang/protobuf 團(tuán)隊(duì)始終明確拒絕添加這一功能。主要原因包括：

1. 語言中立性原則：官方 Protobuf 實(shí)現(xiàn)旨在不與特定編程語言強(qiáng)綁定。標(biāo)簽注入是 Go 特有的需求，其他語言可能無法有效利用這一特性。
2. 維護(hù)邊界：官方認(rèn)為這類功能超出了核心 Protobuf 庫的職責(zé)范圍，更適合由第三方插件或工具實(shí)現(xiàn)。
3. 設(shè)計(jì)哲學(xué)：官方更傾向于保持核心庫的簡潔性和穩(wěn)定性，而非不斷增加語言特定的擴(kuò)展。

替代方案推薦

雖然 gogo/protobuf 已廢棄，但仍有其他選擇：

1. 繼續(xù)使用 gogo/protobuf

盡管不再維護(hù)，但對于已有項(xiàng)目仍可繼續(xù)使用。

2. 使用 protoc-go-inject-tag

這是一個專門用于標(biāo)簽注入的工具，職責(zé)單一且維護(hù)良好。

示例使用：

messageIP{
// @gotags: valid:"ip"
string Address =1;

string MAC =2;// @gotags: validate:"omitempty"
}

生成代碼：

type IP struct{
 Address string`protobuf:"bytes,1,opt,name=Address" json:"Address,omitempty" valid:"ip"`
 MAC     string`protobuf:"bytes,2,opt,name=MAC" json:"MAC,omitempty" validate:"omitempty"`
}

總結(jié)與啟示

官方立場明確：golang/protobuf 堅(jiān)持語言中立原則，不愿支持 Go 特有功能

生態(tài)多樣性：社區(qū)需求催生了 gogo/protobuf 等替代方案，填補(bǔ)了官方庫的空白

維護(hù)可持續(xù)性：單一職責(zé)的工具如 protoc-go-inject-tag 可能比龐大的一站式方案更易維護(hù)

技術(shù)決策權(quán)衡：在選擇 Protobuf 工具鏈時，需在功能豐富性和長期維護(hù)性間取得平衡

這一案例也反映了開源生態(tài)中常見的情況：官方項(xiàng)目保持克制，而社區(qū)填補(bǔ)特定需求。開發(fā)者需要根據(jù)項(xiàng)目需求做出合適的技術(shù)選擇。