Sublime需通过外部工具（buf/prototool）+Build System实现Protobuf一键格式化：先装Protocol Buffer语法插件确保高亮，再配置Build System调用buf format -w（需buf.yaml存在、path正确、selector匹配scope）。
Sublime 本身不提供 Protobuf 格式化能力，必须靠外部工具（buf 或 prototool）+ Build System 集成才能实现一键美化。 直接装插件 ≠ 自动格式化，语法高亮和结构美化是两回事，很多人卡在这一步就以为“配好了”。
安装 Protocol Buffer 语法插件（高亮/缩进基础）
没这步，.proto 文件全是白底黑字，连 syntax、message 都不着色，后续所有构建系统都无效。
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入Package Control: Install Package回车 - 搜索并安装
Protocol Buffer（作者 zensh 或 bennettp123，别选名字带 “protobuf syntax” 但更新停滞的旧版） - 重启 Sublime，新建
test.proto→ 保存后右下角应显示Protocol Buffer；若仍为Plain Text，手动点击右下角 →Open all with current extension as…→ 选Protocol Buffer
配置 Build System 调用 buf format -w（真正格式化动作）
buf 是当前最主流的 Protobuf 工具链，buf format 支持字段对齐、缩进标准化、option 排序等，比原始 protoc 强得多。但 Sublime 默认找不到它。
- 确保
buf已安装且在终端可用：buf --version成功返回；macOS 常用brew install bufbuild/buf/buf - 菜单 →
Tools → Build System → New Build System，粘贴以下内容：
{
"cmd": ["buf", "format", "-w", "$file"],
"selector": "source.protobuf",
"working_dir": "$file_path",
"path": "/opt/homebrew/bin:/usr/local/bin",
"file_regex": "^([^:]+):([0-9]+):([0-9]+):(.*)$"
}
-
"selector": "source.protobuf"必须和你安装的插件声明的 scope 一致；如果插件实际用的是source.proto（查插件源码或View → Developer → Show Scope Name），这里就得改过去，否则Ctrl+B不触发 -
"path"是关键：GUI 启动的 Sublime 不继承 shell 的$PATH，尤其 macOS；路径按你本地which buf输出填写，多个路径用冒号分隔 - 保存为
ProtobufFormat.sublime-build，然后打开任意.proto文件，右下角语法栏旁选择该构建系统
为什么 buf format 有时没反应或缩进错乱？
不是 Sublime 问题，是 buf 的行为限制或配置缺失导致的“假失败”。
-
buf format要求项目根目录存在buf.yaml，哪怕只写一行version: v1；没有它，buf会退化为调用底层protoc，不处理缩进和空行 -
oneof块内字段顺序、跨文件的import排序，buf format明确不调整——这不是 bug，是设计；别指望它重排语义逻辑 - 如果报错
failed to read config: no buf.yaml found，说明buf.yaml缺失或不在$file_path（即当前文件所在目录）及其父级路径中 - Windows 用户注意：
"path"中路径分隔符用分号;，不是冒号
替代方案：prototool format 可用但需额外配置
如果你已用 prototool 管理 lint 规则，它也能格式化，但默认不启用 transform（如 snake_case），需显式配置。
- 安装：
go install github.com/uber/prototool/cmd/prototool@latest - 项目根目录建
prototool.yaml，至少含：
format:
transform:
snake_case: true
- Build System 中
"cmd"改为["prototool", "format", "$file"]，其余同buf配置 - 注意：
prototool对buf.yaml冲突敏感，两个工具不要混用同一项目
真正容易被忽略的是：格式化动作依赖外部二进制的稳定性和配置文件的存在位置，而不是 Sublime 插件本身是否“安装成功”。buf.yaml 放错层级、path 拼错路径、selector 匹配失败——这三个点占了 90% 的调试时间。
