Sublime Text 本身不支持 gRPC 开发，但配对 protoc + 正确插件后可实现高效 .proto 编写与一键生成代码；关键在于 protoc 是否在 PATH、语法是否识别为 proto3、构建系统参数是否写对。
Sublime Text 本身不支持 gRPC 开发，但配对 protoc + 正确插件后，能实现高效、轻量的 .proto 编写与一键生成代码流程——关键不在“能不能”，而在 protoc 是否在 PATH、语法是否识别为 proto3、构建系统参数是否写对。
Protobuf Syntax Highlighting 插件必须启用 proto3 模式
装完 Protobuf Syntax Highlighting 后，service、rpc、returns 这些关键字仍不着色？大概率是插件默认按 proto2 解析。proto2 中没有 service 块，所以整块被当作文本忽略。
- 右下角点击当前语法 → Open all with current extension as → 确保选的是
Protobuf - 菜单栏 → Preferences → Settings – Syntax Specific，在右侧 JSON 中加一行：
"protobuf_version": "proto3" - 保存后文件自动重载，
rpc SayHello会像函数名一样高亮，oneof和optional（proto3 兼容语法）也正常着色 - 注意：这个设置只对当前文件类型（即当前 .proto 文件）生效；混用 proto2/proto3 的项目，得在每个文件里单独配
protoc 必须在系统 PATH 中且版本 ≥ 3.15
高亮只是第一步，后续所有操作都依赖 protoc 可执行文件可用。Ctrl+B 静默失败、生成目录空、或报错 command not found: protoc，基本都是路径或版本问题。
- 终端运行
protoc --version，确认输出类似libprotoc 3.21.12；低于 3.15 的旧版不支持go-grpc插件 - Mac/Linux 检查
echo $PATH是否含protoc所在目录（如/usr/local/bin）；Windows 检查系统环境变量Path是否含安装路径 - Sublime 构建系统中不能写
./protoc或相对路径，必须确保protoc命令全局可调用 - 如果用 Homebrew 安装，
brew install protobuf默认已加入 PATH；手动下载二进制包的，需手动chmod +x并软链到/usr/local/bin/protoc
Sublime 构建系统 cmd 参数顺序不能错
自定义构建系统（Build System）用于一键生成 Go/C#/Python 等语言代码，但 protoc 对参数顺序极其敏感——少个点、路径颠倒、插件名拼错，都会导致静默失败（无错误提示，也不生成文件）。
- Go 服务端生成示例（需提前
go install google.golang.org/protobuf/cmd/protoc-gen-go@latest和go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest）：["protoc", "--go_out=.", "--go-grpc_out=.", "${file}"] - 关键点：
--go_out=.中的.表示“当前目录”，不是占位符；写成--go_out=./或漏掉=.都会失败 - C# 项目不用构建系统生成代码，而是靠 MSBuild 自动调用
Grpc.Tools；但 Sublime 若想预览生成效果，仍需正确配置 protoc 路径和参数 - 建议在构建系统 JSON 中加
"shell": true，便于调试；出问题时先在终端手动跑一遍相同命令，确认是否成功
.proto 文件中 csharp_namespace 和 package 不影响 Sublime，但决定生成代码结构
Sublime 不解析 option csharp_namespace 或 package，但它们直接影响最终生成的 C# 类命名空间和 Go 包路径——写错会导致编译报错，比如找不到 GreeterClient 或类型冲突。
-
option csharp_namespace = "GrpcGreeter"决定生成的GreeterClient所在命名空间，必须与 C# 项目中<protobuf></protobuf>的GrpcServices属性匹配 -
package greet;在 Go 中映射为生成文件的package greet，在 C# 中仅用于避免命名冲突，不参与命名空间构造 - 常见坑：
csharp_namespace值含点号（如"MyCompany.Grpc"）没问题，但若项目中已有同名命名空间且未引用Grpc.Core，编译时会提示类型重复定义 - 建议保持
package简短小写（如greet），csharp_namespace与项目根命名空间一致（如MyApp.Grpc）
真正卡住人的往往不是语法写错，而是 protoc 找不到、构建系统里多敲了一个空格、或者以为高亮了就等于能生成代码——高亮只是视觉反馈，背后工具链每一步都得稳。
