VSCode 中 gRPC-Web 或 Node.js gRPC 服务启动失败，主因是 node 命令不可用、proto 编译缺失或调试配置未对齐；需确保 PATH 正确加载、grpc-tools 全局安装且版本兼容、launch.json 配置适配 ES Module/TS，并区分浏览器与 Node 环境的协议限制。
VSCode 里跑不起来 gRPC-Web 或 Node.js gRPC 服务，90% 是环境链断在 node 命令不可用、proto 编译缺失或调试配置没对齐——不是插件装得不够多，而是 PATH、grpc-tools 和 node 版本三者没咬合上。
node 命令在 VSCode 终端里报 “command not found”
这不是 VSCode 问题，是它启动时没加载 shell 的 PATH。你终端里 node -v 能跑，但 VSCode 集成终端里不行，说明它没继承到你的 shell 初始化文件（比如 ~/.zshrc 或 Windows 的系统环境变量）。
- macOS/Linux：确认
~/.zshrc（或~/.bash_profile）里有类似export PATH="/usr/local/bin:$PATH"，Homebrew 安装的 Node 默认路径就是这个；改完后运行source ~/.zshrc，再彻底退出 VSCode（关所有窗口），重新从 Dock 或命令行code启动 - Windows：安装 Node.js 时必须勾选 “Add to PATH”，没勾就重装；若已装过，手动把
C:\Program Files\nodejs\加进「系统环境变量」的Path，然后重启 VSCode - 验证方式：打开 VSCode 集成终端，直接输
which node（macOS/Linux）或where node（Windows），有输出才算真正就位
gRPC proto 编译失败：找不到 protoc 或 grpc_tools_node_protoc
gRPC-Web 和 Node.js gRPC 都依赖 protoc 编译器 + 对应插件生成 JS/TS 代码。只装 npm install grpc 或 @grpc/grpc-js 不够，编译环节是独立的。
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 先全局装
grpc-tools：npm install -g grpc-tools（注意不是grpc） - 确保
protoc可执行：运行protoc --version；若报错，去 GitHub releases 下对应平台的protoc二进制，解压后把bin/目录加进 PATH - 编译命令示例（假设
hello.proto在proto/下）：grpc_tools_node_protoc --js_out=import_style=commonjs,binary:./src/proto --grpc_out=generate_package_definition:true,grpc_js:./src/proto --plugin=protoc-gen-grpc=grpc_tools_node_protoc_plugin ./proto/hello.proto - 常见坑：
grpc_tools_node_protoc必须和@grpc/grpc-js版本兼容（v1.9+ 推荐用@grpc/grpc-js而非旧版grpc）
VSCode 调试 gRPC 服务时断点无效或报 “Cannot launch program”
VSCode 的 Node.js 调试器（vscode-js-debug）默认不识别 import 语法或打包后的源映射，而 gRPC 项目常含 ES Module 或 TypeScript，容易卡在这步。
- 检查
launch.json是否用了type: "pwa-node"（新版推荐），且runtimeExecutable指向正确node路径（尤其多版本共存时） - 如果用
import语法，launch.json中加"env": { "NODE_OPTIONS": "--experimental-specifier-resolution=node" } - TS 项目必须配
sourceMap: true（tsconfig.json），且outDir和launch.json的program路径一致；调试入口别指向.ts文件，要指向编译后的.js - gRPC-Web 客户端调试更麻烦：浏览器里看不到 Node 服务端断点，只能靠
console.log或debugger在服务端打点，客户端用浏览器 DevTools 查 Network 请求是否发出去、状态码是否 200
运行 gRPC-Web 前端时连不上本地后端
gRPC-Web 协议本身不支持浏览器直连 gRPC 服务（HTTP/2），必须经由反向代理（如 Envoy）或 grpc-web-proxy 转换，VSCode 里直接 node client.js 是能跑通的，但浏览器访问就跨域+协议失败。
- 浏览器场景下，后端必须启用 gRPC-Web 支持：Node 服务端用
@grpc/grpc-js+grpc-web插件（如grpc-web-server），或部署 Envoy 作网关 - 前端 fetch 地址不能写
http://localhost:50051（gRPC 默认端口），得指向代理地址，比如http://localhost:8080 - VSCode 里调试前端，建议用
Live Server插件起静态服务，而非直接双击 HTML——否则跨域拦截无法绕过 - 关键验证点：用
curl -v http://localhost:8080/hello.HelloService/SayHello看是否返回200 OK和 protobuf payload，通了再切浏览器
最易被忽略的是：gRPC-Web 的“前端调用”和“Node 服务端”本质是两套运行时，VSCode 里得开两个终端分别跑 server 和 proxy，而不是幻想一个 F5 全链路启动。proto 编译路径、TS 输出目录、代理端口这三处一旦错位，错误信息往往藏在日志末尾几行，别只盯着第一行报错。
