基于Apollo框架进行C++自动驾驶规划算法的二次开发，需要先搭建适配的开发环境，整个过程涉及系统配置、依赖安装、源码编译等多个环节，每个步骤都需要按照规范操作才能保证后续开发顺利。
环境前置要求
Apollo的规划模块开发对系统和硬件有一定要求，首先需要确认当前环境满足基础条件：
- 操作系统推荐使用Ubuntu 18.04或者Ubuntu 20.04，其他Linux发行版可能存在依赖兼容问题
- 内存建议不低于16GB，规划模块编译过程会占用较多内存资源
- 磁盘剩余空间至少50GB，需要存放源码、编译产物和依赖文件
- 需要提前安装好Docker和NVIDIA驱动（如果有GPU加速需求）
基础依赖安装
首先安装系统层面的基础依赖工具，执行以下命令完成安装：
# 更新软件源 sudo apt-get update # 安装基础编译工具和依赖 sudo apt-get install -y build-essential curl wget git vim cmake # 安装Docker相关依赖 sudo apt-get install -y apt-transport-https ca-certificates software-properties-common
安装完成后需要配置Docker的国内镜像源，加快后续镜像拉取速度，修改/etc/docker/daemon.json文件，添加如下内容：
{
"registry-mirrors": ["https://mirror.ccs.tencentyun.com"]
}
重启Docker服务使配置生效：
sudo systemctl daemon-reload sudo systemctl restart docker
拉取Apollo源码
首先创建存放源码的目录，然后克隆Apollo的官方仓库，规划模块的代码位于modules/planning目录下：
# 创建目录 mkdir -p ~/apollo_workspace cd ~/apollo_workspace # 克隆源码，这里选择稳定的v7.0.0分支 git clone -b v7.0.0 https://github.com/ApolloAuto/apollo.git cd apollo
如果需要基于特定版本做二次开发，可以切换到对应的分支或者标签，避免后续版本更新带来的接口变动问题。
启动Apollo开发容器
Apollo使用Docker容器封装所有编译和运行依赖，执行以下命令启动开发容器：
# 启动容器，该命令会自动拉取对应的镜像并进入容器终端 bash docker/scripts/dev_start.sh # 进入容器内部 bash docker/scripts/dev_into.sh
进入容器后，当前工作目录就是Apollo的源码根目录，所有后续的编译操作都在容器内部完成。
编译规划模块
在容器内部执行编译命令，仅编译规划模块及其依赖，减少编译时间：
# 编译规划模块，--jobs参数指定并行编译任务数，可根据CPU核心数调整 bash apollo.sh build --module planning --jobs 8
如果编译过程中出现依赖缺失的错误，可以执行全量编译先补全所有依赖：
bash apollo.sh build --jobs 8
编译完成后，可以在bazel-bin/modules/planning目录下看到编译生成的可执行文件和库文件。
二次开发调试配置
进行规划算法二次开发时，常用的调试方式有两种：
1. 单元测试调试
规划模块的每个算法组件都有对应的单元测试，修改代码后可以运行对应单测验证功能，例如测试路径规划算法的单测：
# 在容器内部执行，运行路径规划相关的单测 bazel test //modules/planning/planner/public_road:public_road_planner_test
2. 实车或仿真调试
如果需要验证算法在实际场景或者仿真场景的效果，可以启动Apollo的Dreamview可视化工具，加载对应的场景数据运行规划模块：
# 启动Dreamview bash scripts/bootstrap.sh
打开浏览器访问http://127.0.0.1:8888即可进入Dreamview界面，选择对应的车辆和场景，启动规划模块查看算法效果。
常见问题解决
- 编译报错提示内存不足：可以减少并行编译任务数，将
--jobs参数调小，或者增加系统交换空间 - 拉取源码速度慢：可以配置Git的代理，或者切换国内的Git镜像源
- 容器启动失败：检查Docker服务是否正常运行，以及是否有足够的磁盘空间存放镜像
完成环境搭建后，就可以在modules/planning目录下修改对应的算法文件，重新编译后验证修改效果，逐步完成规划算法的二次开发工作。