protobuf语法高亮不生效是因为.proto文件未与语法绑定，需点击右下角plain text→open all with current extension as…→protobuf；若无此选项则重装zjullion的protobuf插件；syntax = "proto3";必须为去除注释后的首行且无bom；build system中selector须匹配source.protobuf，path需包含buf及protoc-gen-go等插件路径。
Protobuf语法高亮不生效，右下角显示Plain Text
装完插件但.proto文件还是白底黑字，说明Sublime没把后缀和语法关联上。这不是插件没装好，而是默认没绑定。
- 打开任意
.proto文件，点击右下角当前语法名（比如Plain Text） - 选
Open all with current extension as…→Protobuf（注意不是Protocol Buffers） - 如果列表里没有
Protobuf，说明插件安装失败或名字不对——重装时搜Protobuf（作者 zjullion），别选带空格的老版本 - 确认后，新打开的
.proto文件会自动高亮syntax、message、字段类型等关键词
写完contacts.proto却编译报错syntax = "proto3" is missing
这个错误不是语法写错了，而是 syntax = "proto3"; 没放在有效位置。protoc 要求它必须是除去注释后的第一行，任何前置空行或 BOM 字符都会让它失效。
- 用 Sublime 的
View → Show Console看当前文件编码，确保是UTF-8（不是 UTF-8 with BOM） - 删掉文件顶部所有空行，让
syntax = "proto3";紧贴第一行，前面不能有任何字符（包括空格） - package 声明必须在 syntax 之后、message 之前，顺序错也会触发类似报错
- 字段编号从
1开始，不能跳号或重复；字段名用lower_snake_case，比如user_name，别写成userName
想一键格式化.proto文件但Ctrl+B没反应
Sublime 的 Build System 不是“装了插件就自动可用”，它依赖三件事：插件 scope 匹配、buf 可执行路径、构建命令中 selector 和实际语法 scope 一致。
- 先在终端运行
buf --version，确认已安装且路径正确；macOS 上常用brew install bufbuild/buf/buf - 打开一个
.proto文件，按Ctrl+Shift+P→Developer: Show Scope Name，看底部显示的是source.protobuf还是source.proto - 新建 Build System 时，
"selector": "source.protobuf"必须和上面查到的 scope 完全一致，否则 Ctrl+B 不触发 -
"path"字段填你本地which buf输出的路径，比如/opt/homebrew/bin，多个路径用冒号分隔，Windows 用分号
生成Go代码时提示protoc-gen-go: plugin not found
这不是 protoc 本身的问题，而是 Go 插件没装进系统 PATH，或者版本不匹配。protoc 只负责调用，真正干活的是 protoc-gen-go 和 protoc-gen-go-grpc。
- 运行
go install google.golang.org/protobuf/cmd/protoc-gen-go@latest（不是github.com/golang/protobuf，那是旧版） - 运行
go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest - 检查
$(go env GOPATH)/bin是否在系统 PATH 中；Sublime GUI 启动时不继承 shell PATH，必须显式写进 Build System 的"path" - 生成命令要带插件参数：
protoc --go_out=. --go-grpc_out=. contacts.proto，缺任何一个--xxx_out都不会生成对应代码
