BloomRPC不是VSCode插件，而是基于Electron的独立GUI客户端，其源码无VSCode扩展声明；它与VSCode协同工作：VSCode开发调试gRPC服务端，BloomRPC连接并测试该服务。
VSCode 本身不运行 gRPC 服务，它只负责启动、调试或构建服务代码；BloomRPC 是独立的 GUI 客户端，不是 VSCode 插件 —— 这是常见误解的根源。
为什么 BloomRPC 不是 VSCode 插件
BloomRPC 是一个基于 Electron 的桌面应用，源码仓库中没有 package.json 声明为 VSCode 扩展，也没有 activationEvents 或 contributes 字段。它的调试配置（如 .vscode/launch.json）仅用于开发 BloomRPC 自身，而非让它“嵌入”VSCode。你看到的“BloomRPC 插件”说法，多源于混淆了“用 VSCode 开发 BloomRPC”和“在 VSCode 里装 BloomRPC 插件”。
- 官方 releases 页面（
https://github.com/uw-labs/bloomrpc/releases）只提供 macOS / Windows / Linux 二进制安装包 - 所有文档提到的“导入 proto”“填地址发请求”，都是 BloomRPC 主窗口里的操作，不是 VSCode 面板或命令面板功能
- VSCode 中能直接调用 gRPC 的扩展（如
grpc-vscode）目前仅支持语法高亮与 proto 编辑，不提供运行时客户端能力
VSCode 如何配合 BloomRPC 测试 gRPC 服务
真正可行的工作流是：VSCode 负责写、跑、调你的 gRPC server，BloomRPC 负责连它、发请求、看响应。两者通过网络通信协作，不是父子进程或插件依赖关系。
- 确保你的 gRPC server 已在 VSCode 中启动（例如用
dotnet run或npm start），监听地址如0.0.0.0:50051 - 在 BloomRPC 地址栏输入相同地址（注意：不要输
http://前缀，直接写localhost:50051或127.0.0.1:50051） - 若服务启用了 TLS，必须在 BloomRPC 中勾选
TLS并导入对应证书 —— 否则会卡在SSL handshake failed - VSCode 的终端里运行
telnet localhost 50051或nc -zv localhost 50051，能通才说明 BloomRPC 有希望连上
BloomRPC 连不上？先查这三件事
90% 的连接失败不是 BloomRPC 问题，而是服务暴露或网络配置没对齐。
-
grpcurl能通但 BloomRPC 不行？大概率是 TLS 配置漏项：BloomRPC 要求显式导入.crt+.key（服务端证书）和.ca（根证书），而grpcurl -insecure可跳过验证 - proto 文件导入后看不到服务？检查
syntax = "proto3"和service块是否在顶层，且没有被package隔离到子目录导致 BloomRPC 解析失败 - 点击发送后无响应也无错误？不是超时，是底层 HTTP/2 连接被拦截 —— 检查 Windows Defender 防火墙、Docker 网络模式（host vs bridge）、Kubernetes Service 的
port与targetPort是否一致
真正麻烦的是双向流（stream）场景：BloomRPC 支持，但 proto 里只要有一个字段类型写成 repeated 而非 stream，或者 server 返回顺序错乱，界面就可能卡死或静默失败。这种细节没法靠工具自动校验，得盯住 server 日志和 BloomRPC 控制台输出（启用 DEBUG=bloomrpc:* 环境变量启动）。
