apollo 项目无需配置 node 环境调试服务，因其核心为 c++ 二进制且由 bazel 构建；node 仅用于前端页面、cli 工具或本地 mock 接口；vscode 应配置 clangd、bazel 插件及 compile_commands.json 以支持 c++ 开发。

VSCode 里配 Node 环境本身很简单，但 Apollo 不是 Node 服务——它用 Bazel 构建、C++ 主体、运行在容器或裸机上；强行套 Node 调试流程会卡在 launch.json 配置、node --inspect、process.env.PORT 这些地方，根本起不来。

Node 环境配置只对 Apollo 的配套工具链有用

Apollo 项目里真正需要 Node 的场景有限：比如跑前端调试页面（modules/dreamview）、执行部分 Python 脚本包装的 CLI 工具、或本地 mock 数据接口。这些才是 node 和 npm 发挥作用的地方。

• 确认 node -v 和 npm -v 在终端可用，PATH 必须包含 Node 安装路径（尤其在 Docker 容器外使用 VSCode 时）
• 不要在 Apollo 根目录下直接 npm init —— 它没有 package.json，也不走 npm 生命周期
• 如果要用 express 或 http-server 起一个本地静态页看 BEV 可视化结果，才需要装对应依赖，且应放在子目录如 tools/vis-server/ 下独立管理

Apollo 服务不能用 VSCode 的 Node 调试器启动

VSCode 默认的 Node.js 调试类型（type: "node"）依赖 node 进程启动，而 Apollo 模块（如 perception、planning）是编译后的 C++ 二进制，靠 bazel run //modules/planning:planning 或容器内 ./scripts/bootstrap.sh 启动。

Rydberg Agent Node

使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r

下载

• launch.json 里写 "type": "node" + "program": "./bazel-bin/modules/planning/planning" 会报错：Cannot launch program because corresponding JavaScript file cannot be found
• 正确做法是用 cppvsdbg（Windows）或 gdb（Linux/macOS），配合 compile_commands.json 和符号文件（.debug 或未 strip 的 binary）
• 远程调试必须走 SSH 连入 Apollo 容器，再 attach 到进程 PID，不是本地启动

VSCode 中 Apollo 开发真正要配的是 C++/Bazel 工具链

你花时间配 Node，不如把 clangd、Bazel 插件和 compile_commands.json 弄明白——这才是跳转定义、补全函数、查看宏展开的基础。

• 安装 clangd 插件后，在 Apollo 根目录运行：buildtool build --compilation_database --dbg-p //modules/perception/... 生成 compile_commands.json
• .vscode/c_cpp_properties.json 中 "compileCommands" 字段必须指向该文件绝对路径，否则 clangd 无法解析头文件包含
• Bazel 插件能识别 BUILD 文件结构，但不提供调试能力；它只帮你 hover 看 target 依赖、右键跳转到 cc_library 定义
• 别信网上“用 Prettier 格式化 BUILD”的教程——Starlark 语法支持不稳定，prettier-plugin-starlark 对 Apollo 8.0+ 的宏（如 cc_proto_library）经常格式错位

Apollo 的核心不在 Node，而在构建时的 Bazel 规则、运行时的 ROS2/Bazel runtime、调试时的 GDB 符号链。把 VSCode 当成 C++ IDE 用，而不是 Node 编辑器，才能避开最深的坑。