必须装Protocol Buffer（作者xwmx或bennettp123），重启Sublime后通过“Open all with current extension as…”全局绑定.proto扩展名，并确认插件解压至Packages/Protocol Buffer/目录，才能实现正确高亮。
装对插件、完成全局绑定、确认路径无误，.proto 文件才能真正高亮；装错名字、没重启、只点一次右下角，90% 的“不生效”问题都出在这三步里。
Protocol Buffer 插件该装哪个才不踩坑
必须装 Protocol Buffer（作者 xwmx 或 bennettp123），别被名字带 “Google Protocol Buffers”“protobuf syntax” 的包迷惑——它们大多停更多年，连 import "google/protobuf/timestamp.proto" 都解析失败。
-
Protocol Buffer（xwmx/bennettp123）：支持syntax = "proto3";、map<string, int32>、repeated、enum全语法高亮，更新频繁，兼容性最稳 -
Protobuf（mikemcquaid/mattjgalloway）：部分版本漏识别syntax声明，proto3 场景下容易漏着色 - 所有带 “Syntax” 字样的冷门包：基本不维护，
optional在 proto3 中已废弃，但这些包仍错误地把它当关键字，且无法识别oneof等新结构
为什么 .proto 文件打开还是 Plain Text
不是插件没装，而是 Sublime 没把 .proto 扩展名和语法绑定上。常见操作误区：
- 右下角点一次 → 选
Protocol Buffer：这只改当前文件，关掉重开就失效 - 必须再点一次右下角 →
Open all with current extension as…→ 选Protocol Buffer：这才是永久绑定.proto的关键动作 - 没重启 Sublime：插件安装后必须重启，否则 Packages 目录加载不全，新建
test.proto也看不到高亮 -
Packages/User/Preferences.sublime-settings里写了冲突的"extensions"规则，比如"*.proto": "Plain Text"，会直接覆盖插件绑定
message / enum 不着色 or 颜色太淡怎么办
语法高亮分两层：语法定义（.sublime-syntax）决定哪些词被识别，主题（.sublime-color-scheme）决定怎么渲染。很多人混为一谈：
-
message、package、repeated完全不着色 → 说明语法定义损坏或未加载：用PackageResourceViewer: Open Resource查看插件是否真解压到了Packages/Protocol Buffer/目录下，而不是卡在Packages/User/或下载中断 - 词都识别了但颜色发灰、和背景融合 → 主题对比度太低：进
Preferences → Color Scheme换成Monokai Extended或Brogrammer这类高对比主题 -
optional被高亮了？正常。proto3 已废弃它，但插件保留 keyword 规则以兼容 proto2，不影响 protoc 编译，也不建议手动删
高亮之后下一步：protoc 和 Build System 怎么配
高亮只是编辑起点，真实工程中很快要生成代码、格式化、跳转 import。这些不靠插件，得手动配：
- 必须装
protocv3.21+（推荐 v24.4），并确保它在PATH中可执行：终端运行protoc --version要能返回版本号 - 一键生成 Go 代码？建
Build System："cmd": ["protoc", "--go_out=.", "${file}"]，注意路径不能含空格或中文，参数顺序不能颠倒 - 想让
import "google/protobuf/timestamp.proto"支持跳转？插件需配置protobuf.protocArgs数组（不是字符串），值为工作区根相对路径，如["--proto_path=.", "--proto_path=third_party/googleapis"] - 格式化不能靠插件：Sublime 本身不支持，必须用
buf format -w或prototool format配 Build System，且项目根目录要有buf.yaml
最容易被忽略的是：高亮生效 ≠ 编辑体验完整；optional 被着色不是 bug；Open all with current extension as… 必须点两次；protocArgs 是数组不是字符串——这几个点卡住的人最多，而且错误现象不报错，只默默不工作。
