Golang中如何不硬编码字段名获取protobuf的FieldDescriptor

方案1：使用生成的字段编号常量（无额外依赖，官方原生支持） #

protoc-gen-go 会自动为每个proto字段生成对应的字段编号常量，命名格式为 {消息名}_{字段名}FieldNumber，完全不需要硬编码字符串，你可以直接匹配字段描述符的编号：

// 遍历field mask中的字段路径
for _, p := range mask.GetPaths() {
    fieldDescriptor := fieldDescriptors.ByTextName(p)
    if fieldDescriptor == nil {
        return
    }
    // 直接匹配字段编号，避免硬编码字段名
    switch fieldDescriptor.Number() {
    case pb.MyMsg_MyFieldFieldNumber:
        // 处理my_field更新逻辑
    case pb.MyMsg_YourFieldFieldNumber:
        // 处理your_field更新逻辑
    }
}

这是最推荐的方案，完全基于官方生成的代码，不需要额外插件，字段删除/修改编号时，IDE会直接标红报错，编译也无法通过，完全满足静态检查的需求。

方案2：用插件生成字段名字符串常量 #

如果你的场景确实需要用到字段名字符串（比如构造FieldMask），可以安装protoc-gen-go-fieldnames插件，在生成Go代码时加上该插件的生成参数，会自动为每个字段生成对应的字符串常量，示例生成的常量如下：

const (
    MyMsgMyFieldName = "my_field"
    MyMsgYourFieldName = "your_field"
)

使用时直接引用常量即可：

fieldDescriptor := fieldDescriptors.ByTextName(pb.MyMsgMyFieldName)

修改proto字段名后重新生成代码，常量值会自动更新，引用了旧常量的代码编译时会报错。

方案3：反射读取结构体标签（无需额外插件） #

不想安装第三方插件的话，也可以自己写通用工具函数，通过结构体字段获取对应的proto字段名，利用反射读取protobuf标签：

import (
    "reflect"
    "strings"
)

// GetProtoFieldName 传入消息实例和消息字段的指针，返回对应的proto字段名
func GetProtoFieldName(msg any, fieldPtr any) string {
    msgVal := reflect.ValueOf(msg).Elem()
    for i := 0; i < msgVal.NumField(); i++ {
        if msgVal.Field(i).Addr().Interface() == fieldPtr {
            tag := msgVal.Type().Field(i).Tag.Get("protobuf")
            return parseProtobufTagName(tag)
        }
    }
    return ""
}

// parseProtobufTagName 解析protobuf tag提取name属性
func parseProtobufTagName(tag string) string {
    parts := strings.Split(tag, ",")
    for _, part := range parts {
        if strings.HasPrefix(part, "name=") {
            return strings.TrimPrefix(part, "name=")
        }
    }
    return ""
}

使用方式：

myMsg := &pb.MyMsg{}
fieldName := GetProtoFieldName(myMsg, &myMsg.MyField)
fieldDescriptor := fieldDescriptors.ByTextName(fieldName)

如果MyField字段被删除，&myMsg.MyField 这段代码编译时就会报错，也能满足静态检查的需求。

内容的提问来源于stack exchange，提问作者Jack