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 启动。
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
-
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 编辑器，才能避开最深的坑。
