
Autoware 安装与配置完全指南从零搭建自动驾驶软件栈只需一步脚本【免费下载链接】autowareAutoware - the worlds leading open-source software project for autonomous driving项目地址: https://gitcode.com/GitHub_Trending/au/autowareAutoware 是业界领先的开源自动驾驶软件项目基于 ROS 2 构建覆盖定位、感知、规划、控制全流程。它适合想进入自动驾驶领域的开发者和学生本指南带你完成 Autoware 安装与配置脚本化装依赖只需一小时左右拉取预构建镜像几分钟即可跑通。 一分钟认识它Autoware 解决的是让车自己开起来的软件全栈问题它不是单个算法而是把传感器数据处理、目标检测、路径规划、车辆控制串成一套可运行的生产级系统。你平时听到的自动驾驶框架大多要自己拼装而 Autoware 直接给出了完整答案。项目的主要开发语言是 C性能关键路径和 Python脚本与工具构建与运行都架在 ROS 2 上——你可以把 ROS 2 理解成自动驾驶界的消息总线各模块通过话题、服务互相通信无需直接调用。值得强调的是这个仓库本身是个元仓库它不直接存放全部源码而是用清单文件 repositories/autoware.repos 指向几十个子仓库再用一条命令把它们统一拉到 src/ 下。这也是新手常困惑的点——为什么 clone 下来的目录看起来空空的答案就在 src/README.md 里。⚠️ 开工前的环境清单动手前先对照下表确认任何一行不满足都会在后面卡住你项目要求如何验证 / 用途操作系统Ubuntu 22.04对应 ROS 2 Humble或 24.04对应 ROS 2 Jazzy运行lsb_release -a查看版本号其他版本官方未支持装环境脚本会直接报错磁盘空间建议预留 100GB 以上源码子仓库、编译产物与 ML 模型都要落地df -h查看剩余空间内存建议 32GB 以上free -h查看源码全量编译是内存大户不足时请走预构建镜像路线GPU可选NVIDIA 卡 驱动或无 GPU 亦可nvidia-smi能正常输出版本号即可用 CUDA 路线没有 GPU 用 CPU 软件渲染也完全能跑Docker安装 Docker 与 Compose v2docker version与docker compose version均有正常输出镜像路线和开发容器都依赖它️ 动手安装阶段一 · 地基装好核心框架与依赖这一步在干什么把 Autoware 的元仓库 clone 下来然后用项目自带的 Ansible 剧本一次性装好 ROS 2、构建工具链等全部系统依赖省去手工敲几十条 apt 命令。先拿到仓库并装好 Ansible官方要求通过 pipx 安装 10.x 版本apt 源里的版本太旧需先卸载git clone https://gitcode.com/GitHub_Trending/au/autoware ~/autoware cd ~/autoware # 卸载可能存在的旧版 ansible再装新版 sudo apt-get purge -y ansible sudo apt-get -y update sudo apt-get -y install pipx python3 -m pipx ensurepath pipx install --include-deps --force ansible10.*再安装 Ansible 集合并运行主剧本把整个开发环境铺平需输入一次 sudo 密码22.04 自动匹配 Humble24.04 自动匹配 Jazzyansible-galaxy collection install -f -r ansible-galaxy-requirements.yaml ansible-playbook autoware.dev_env.install_dev_env --ask-become-pass剧本细节和可用参数以官方文档为准各角色说明见 ansible/playbooks/install_dev_env.yaml。阶段二 · 主体获取项目源码并构建这一步在干什么把清单里引用的所有子仓库拉进src/然后选择源码编译或预构建镜像其一——初学者推荐先走镜像路线编译可以后面再学。cd ~/autoware # 若提示 vcs 不存在sudo apt install python3-vcs2l vcs import src repositories/autoware.repos colcon build # 全量源码编译耗时数小时且吃内存可择日再跑镜像路线只需一条命令拉取官方预构建的开发镜像默认 JazzyHumble 把标签改成universe-devel-humble即可docker pull ghcr.io/autowarefoundation/autoware:universe-devel-jazzy阶段三 · 调通环境激活与首次启动这一步在干什么激活构建好的 ROS 环境进入开发容器做首次冒烟测试确认消息中间件和节点发现都工作正常。容器要显示图形界面rviz2 会用到先授权 Docker 连接本机 X 服务器再用仓库自带的 compose 文件起容器无 GPU 主机用dev-cpuNVIDIA 用dev-nvidiaIntel/AMD 用dev-dri均在 docker/examples/basic/ 下xhost local:docker HOST_UID$(id -u) HOST_GID$(id -g) \ docker compose -f docker/examples/basic/dev-cpu.compose.yaml run --rm autoware进入容器后先加载 Autoware 安装空间再做健康检查源码编译路线则是source install/setup.bash具体变量与启动方式以官方文档为准source /opt/autoware/setup.bash ros2 doctor✅ 30 秒验证是否装好你应该看到ros2 doctor输出多节报告RMW 实现、ROS 版本、中间件、节点与话题信息等逐项列出且没有 ERROR 字样类似RMW implementation: rmw_fastrtps_cpp、ROS version: 2.x这样的正常条目。没看到时先检查两处一是当前 shell 是否真的 source 过安装空间的setup.bash容器内是/opt/autoware/setup.bash源码路线在install/下二是ros2 doctor若报网络或接口问题确认容器网络模式与宿主是否互通。 新手最容易踩的 4 个坑现象vcs import提示vcs: command not found→ 原因 → 解决办法环境脚本默认你已装 vcs2lvcs命令来自它。先执行sudo apt install python3-vcs2l再重跑 import 即可。现象colcon build中途卡死或报内存不足 → 原因 → 解决办法全量编译几十个包会长时间占满内存和磁盘。降低并行度colcon build --parallel-workers 2或先放弃源码编译直接用预构建镜像把环境跑起来再学构建。现象compose 报bind source path does not exist→ 原因 → 解决办法compose 文件会挂载~/autoware_data/maps和~/autoware_data/ml_models但它不会替你创建这两个目录。手动mkdir -p建好或运行demo_artifacts角色自动放置示例地图与模型后再起容器。现象容器里 rviz2 黑屏、GUI 弹不出来 → 原因 → 解决办法没执行xhost local:dockerX 服务器拒绝 Docker 连接。执行后重启容器若仍黑屏检查DISPLAY变量是否为空。 下一步官方文档站安装、演示、开发规范的完整说明以官方文档为准仓库 README 中Get Started一节有入口元仓库机制与子仓库版本管理src/README.md、repositories/ 目录跑一个仿真 demodocker/examples/demos/planning-simulator/ 下就是配置好的 planning simulator 启动文件含无 GPU / Intel / AMD / NVIDIA 四种启动姿势环境剧本全览ansible/playbooks/ 里的install_dev_env.yaml是装依赖的主入口install_image_deps.yaml面向镜像构建镜像构建细节与 CUDA 路线docker/README.md【免费下载链接】autowareAutoware - the worlds leading open-source software project for autonomous driving项目地址: https://gitcode.com/GitHub_Trending/au/autoware创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考