必须用hbenl.vscode-protobuf插件，它由protocol buffers官方团队维护，支持import跳转、service导航和跨文件语义校验；其他如zxh404.vscode-proto3等插件仅做语法高亮，不调用protoc，无法实现路径校验与跳转。
装哪个插件才能真正支持 import 跳转和语义校验
必须用 hbenl.vscode-protobuf，其他名字带“proto3”“support”“grpc”的插件基本没用。它由 Protocol Buffers 官方团队维护，能调用本地 protoc 做 AST 解析，实现 Ctrl+Click 跳转 import、service 导航、跨文件字段引用检查。
zxh404.vscode-proto3 只做语法高亮和基础补全，不调用 protoc，路径不校验，大型项目里跳转必失效；名字含 “support” 或作者不是 hbenl 的插件，90% 已停更，v21+ 的 protoc 下直接报 file not found。
安装后必须重启整个 VS Code 窗口（不是重载窗口），且工作区必须是以文件夹形式打开——单文件打开时插件静默不激活。
protoc 路径配错会导致所有跳转标红
hbenl.vscode-protobuf 不查系统 PATH，也不 fallback 到当前目录，路径写错 = import 跳转失效 + 语法标红 + 校验不触发。
必须在 settings.json 中硬编码绝对路径：
- Windows 示例：
"protobuf.protocPath": "D:/dev_tools/protoc-24.4-win64/bin/protoc.exe" - macOS/Linux 示例：
"protobuf.protocPath": "/usr/local/bin/protoc"
注意：路径不能含空格或中文；反斜杠 \ 会静默失败，一律用正斜杠 /；推荐用 protoc v21.12（老项目稳）或 v24.4（修复多级 import bug），避开 Homebrew 自带的过时 v3.x。
多级 import 或跨目录 proto 文件怎么让跳转生效
如果项目结构是 common/proto/ 和 service/api/proto/，编译时用 protoc -Icommon/proto -Iservice/api/proto，VS Code 默认只认工作区根为 -I 路径，其余路径无法解析。
需在 settings.json 中配置 protobuf.protocArgs：
- 正确写法：
"protobuf.protocArgs": ["-I", "common/proto", "-I", "service/api/proto"] - 不能写成
"-I common/proto -I service/api/proto"（插件不解析空格分隔参数） - 路径是相对于工作区根的相对路径，不是绝对路径
若 import "xxx.proto" 仍标红，检查该文件是否真在某个 -I 路径下可被找到——插件不会自动搜索子目录，也不会 fallback 到当前文件所在目录。
格式化要用 Prettier 还是 clang-format？Buf 怎么加进来
hbenl.vscode-protobuf 本身不提供格式化，得靠外部工具。它支持两种主流方式：
- 选
Prettier：装esbenp.prettier-vscode，再在settings.json里设"[protobuf]": {"editor.defaultFormatter": "esbenp.prettier-vscode"} - 选
clang-format：装llvm-vs-code-extensions.vscode-clangd或独立clang-format二进制，配好clang-format.executable
如果项目用 buf，得额外装 bufbuild.vscode-buf 插件，并手动配 buf.path 绝对路径；buf.yaml 必须放在工作区根目录，命名不能是 buf.yml 或 .buf.yaml；files.associations 必须设为 "*.proto": "protobuf"，否则插件接管不了文件。
格式化快捷键（如 Alt+Shift+F）不生效，大概率是语言模式没切对——右键编辑器 → “Change Language Mode” → 手动选 Protocol Buffer；hbenl.vscode-protobuf 和 zxh404.vscode-proto3 可共存，前者管跳转，后者补高亮，但别装一堆名字相似的插件，容易冲突。
