Sublime中需通过Protobuf插件+buf工具链实现.proto文件格式化：安装语法高亮插件、配置Build System调用buf format -w，并确保buf在PATH中且有正确buf.yaml。
Protobuf 文件在 Sublime 里没有原生格式化支持
Sublime Text 默认不识别 .proto 文件的语法结构，更不会自动缩进、对齐字段或排序选项——它连 syntax highlighting 都得靠插件补。所以“一键格式化”这事，本质是拼装三块：语法高亮 + 格式化命令绑定 + 后端格式化工具链。
必须装 Protobuf 插件和 protoc 编译器
缺一不可。插件只负责把内容传给 protoc，而 protoc 自带的 --encode/--decode 不干格式化的事；真正起作用的是社区扩展工具：
-
protoc-gen-go等语言插件不参与格式化，别指望它们 - 要用
protoc-gen-pretty或buf format（推荐）——buf更稳定，支持嵌套缩进、保留注释、识别edition = "2023" - 确保
buf在$PATH里，运行buf --version能返回结果 - Sublime 插件如
Protobuf Syntax Highlighting（作者：brandonc）仅提供高亮，需另配External Tools或Build System
用 Build System 绑定 buf format 实现真正一键
不是快捷键映射，而是让 Sublime 把当前文件丢给 buf format -w 原地覆盖。关键点在于路径和工作区：
- 新建 Build System：
Tools → Build System → New Build System - 填入以下内容并保存为
Protobuf.sublime-build：
{
"cmd": ["buf", "format", "-w", "$file"],
"selector": "source.protobuf",
"working_dir": "$file_path",
"file_regex": "^([^:]+):([0-9]+):([0-9]+):(.*)$"
}
注意："selector": "source.protobuf" 必须匹配你安装的 Protobuf 语法插件所声明的 scope；如果插件用的是 source.proto，这里就得改过去，否则 Build 不触发。
常见失败原因：缩进错乱、注释消失、buf 找不到
这三类问题占了调试时间的 90%：
- 缩进错乱 → 检查
buf.yaml是否存在且含version: v1；没配置文件时buf format会退化成原始protoc行为，不处理缩进 - 注释消失 →
buf2023 年后版本才默认保留行内注释；旧版请升级，或改用protoc-gen-pretty --no-keep-comments=false -
buf找不到 → Sublime 的 Build System 默认不读 shell 的$PATH（尤其 macOS GUI 启动时）；解决方法：在Protobuf.sublime-build里加"path": "/opt/homebrew/bin:/usr/local/bin"（按你实际安装路径调整）
格式化不是万能的，比如 oneof 块里的字段顺序、跨文件的 import 排序，buf format 不动。这些得靠人工约定或 CI 阶段用 buf lint 卡住。
