从零搭建Apollo 8.0自动驾驶仿真系统：全流程实战指南
当你第一次打开Apollo开源平台时，面对数十个模块和复杂的文档体系，很容易陷入"从哪开始"的困惑。本文将以一个园区低速循迹场景为例，带你用Apollo 8.0完成从地图制作到控制指令下发的完整闭环。不同于理论概述，我们将聚焦可立即复现的实操步骤，通过终端命令和配置文件修改的实时对照，让你在2小时内获得第一个自动驾驶仿真结果。
1. 环境准备与基础配置
在开始前需要准备以下硬件环境：
- 计算设备：至少4核CPU/8GB内存/20GB存储（推荐使用NVIDIA显卡加速）
- 操作系统：Ubuntu 20.04 LTS（这是Apollo 8.0官方支持版本）
- 网络环境：稳定访问GitHub和Docker Hub
安装核心依赖项：
# 安装Docker引擎 sudo apt-get update sudo apt-get install docker.io sudo systemctl enable docker sudo usermod -aG docker $USER # 安装NVIDIA容器工具（如有显卡） distribution=$(. /etc/os-release;echo $ID$VERSION_ID) curl -s -L https://nvidia.github.io/nvidia-docker/gpgkey | sudo apt-key add - curl -s -L https://nvidia.github.io/nvidia-docker/$distribution/nvidia-docker.list | sudo tee /etc/apt/sources.list.d/nvidia-docker.list sudo apt-get update && sudo apt-get install -y nvidia-docker2提示：执行完用户组修改后需要重新登录终端才能使docker权限生效
验证环境是否就绪：
docker run --rm hello-world # 验证Docker nvidia-docker run --rm nvidia/cuda:11.0-base nvidia-smi # 验证GPU支持2. 高精地图构建与加载
Apollo使用OpenDRIVE格式的高精地图，我们将通过以下步骤创建简易园区地图：
- 安装LGSVL仿真器（提供地图编辑工具）：
wget https://github.com/lgsvl/simulator/releases/download/2021.3/lgsvlsimulator-linux64-2021.3.zip unzip lgsvlsimulator-linux64-2021.3.zip cd simulator-linux64-2021.3 ./simulator绘制基础路网：
- 在LGSVL界面选择"Map Editor"
- 使用"Lane"工具绘制双向两车道环形路线
- 设置车道属性：宽度3.5米，限速10km/h
- 导出为
circuit.xodr文件
转换Apollo地图格式：
# 在Apollo容器中执行 ./apollo.sh clean && ./apollo.sh build ./scripts/msdream_converter.py circuit.xodr modules/map/data/circuit关键配置文件modules/map/data/circuit/base_map.xml需要检查以下参数：
<header> <vendor>YourName</vendor> <district>TestZone</district> <version>1.0</version> <left_boundary>-100.0</left_boundary> <right_boundary>100.0</right_boundary> </header>3. 定位与感知模块配置
3.1 初始化定位系统
Apollo提供多种定位方式，我们采用NDT定位作为入门方案。修改modules/localization/conf/localization.conf：
localization_type: NDT enable_lidar_localization: true enable_gnss: false enable_imu: true启动定位模块：
cyber_launch start modules/localization/launch/ndt_localization.launch注意：首次运行需要下载NDT地图样本，约需5分钟完成初始化
3.2 配置摄像头感知
使用Apollo预训练的YOLOv4模型进行障碍物检测，编辑modules/perception/production/conf/perception/camera/fusion_camera_detection_component.pb.txt：
camera_names: "front_6mm" output_final_obstacles: true min_crop_size: 240 enable_undistortion: false启动感知管道：
cyber_launch start modules/perception/launch/perception.launch验证感知输出：
# 新终端执行 cyber_monitor在监控界面应能看到/apollo/perception/obstacles通道数据
4. 预测与规划模块联调
4.1 基于规则的预测配置
创建简易预测规则modules/prediction/conf/prediction_conf.pb.txt：
obstacle_conf { obstacle_type: VEHICLE priority: 0.8 interactive_tag: false } evaluator_type: COST_EVALUATOR4.2 规划器参数调优
针对低速场景修改modules/planning/conf/planning_config.pb.txt：
default_task_config: { task_type: LANE_FOLLOW lane_follow_config: { lane_change_prepare_length: 5.0 min_lane_change_prepare_time: 2.0 } } planner_type: PUBLIC_ROAD enable_reference_line_provider: true关键参数对照表：
| 参数 | 推荐值 | 作用 |
|---|---|---|
| max_acceleration | 1.5 m/s² | 最大加速度限制 |
| max_deceleration | -1.5 m/s² | 最大减速度限制 |
| planning_distance | 50.0 m | 规划视野距离 |
| trajectory_time_length | 8.0 s | 轨迹时间跨度 |
启动规划模块：
cyber_launch start modules/planning/launch/planning.launch5. 控制模块与仿真验证
5.1 MPC控制器配置
修改modules/control/conf/control_conf.pb.txt启用MPC控制：
control_task_type: MPC_CONTROLLER mpc_controller_conf { ts: 0.01 cf: 155494.663 cr: 155494.663 } lat_controller_conf { preview_window: 10 }5.2 启动Dreamview可视化
./scripts/bootstrap.sh start在浏览器访问localhost:8888后：
- 选择"Tasks"标签页
- 依次启动"Sim Control"和"Module Controller"
- 在地图下拉菜单选择
circuit地图
操作流程示意图：
- 点击"Route Editing"绘制行驶路线
- 在"Default Routing"设置起点/终点
- 点击"Send Routing Request"开始仿真
常见问题排查：
# 查看模块状态 ./scripts/bootstrap.sh status # 查看具体模块日志（以planning为例） tail -f data/log/planning.INFO当你在Dreamview中看到车辆开始沿预定路线行驶时，恭喜完成了第一个完整的Apollo自动驾驶仿真！这个基础框架可以进一步扩展：
- 在感知环节添加多传感器融合
- 尝试更复杂的Lattice规划器
- 接入真实CAN总线硬件进行实车测试
