Google Proto JS编译器枚举值命名样式的可配置选项

当前业务侧维护的proto定义如下：

option java_package = "com.packageName.proto.device";
option java_outer_classname = "PlatformEntity";

/* Supported Platforms */
enum Platform {
    iOS = 1;
    Android = 2;
    Web = 3;
    Backend = 4;
}

通过官方Protobuf JS编译器默认配置生成的JS代码结构为：

var jspb = require('google-protobuf');
var goog = jspb;
var global = Function('return this')();

goog.exportSymbol('proto.Platform', null, global);
/**
 * @enum {number}
 */
proto.Platform = {
  IOS: 1,
  ANDROID: 2,
  WEB: 3,
  BACKEND: 4
};

goog.object.extend(exports, proto);

根据Protobuf官方风格指南要求，proto枚举值需使用全大写形式定义，但当前场景下无法直接修改proto源文件的枚举命名——改动会直接破坏存量业务数据兼容性、配套报表的口径一致性。核心诉求为：在JS代码编译阶段，通过配置或定制方案，让编译输出的JS枚举值完全保留proto源文件中的原有命名样式。

• 定制改造官方JS protoc生成插件
  官方默认的protoc-gen-js在生成枚举值时，内置了固定的命名转换逻辑：会将proto中定义的枚举名按规则转为全大写下划线分隔的形式，且未提供可关闭该转换的配置项。可基于官方生成器源码做二次裁剪，删除枚举名转换逻辑，直接读取proto语法树中存储的枚举原始名称，原样写入生成的JS代码中。改造后生成的枚举块将完全保留proto中的命名：

  proto.Platform = {
    iOS: 1,
    Android: 2,
    Web: 3,
    Backend: 4
  };
  

  整个过程不需要修改proto源文件的任何定义，仅调整代码生成逻辑。
• 适配buf工具链的自定义生成配置
  如果团队使用buf作为proto统一编译工具，可在buf.gen.yaml配置中，将默认指向官方JS生成器的路径，替换为上述改造后的本地自定义生成插件，即可跳过官方默认的枚举名转换流程，不需要额外编写重复的编译脚本。
• 生成后批量处理脚本（适合临时快速落地场景）
  若暂不具备改造生成器的条件，可在protoc编译流程执行完成后，增加一段自动化处理逻辑：从源proto文件中提取所有枚举的原始名称列表，匹配生成的JS文件中的枚举定义块，将官方自动转换出来的大写下划线键值，替换为对应的原始枚举名。注意需自动从proto文件提取映射关系，不要硬编码枚举名称，避免后续proto新增枚举时脚本失效。

补充说明：以上所有方案均不会改动proto源文件的原始定义，既不影响Java、Go等其他语言的代码生成结果，也不会改变Protobuf二进制序列化的数据格式，不会对现有业务链路造成兼容性影响。

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