carla-simulator/carla
硬件与物联网面向自动驾驶研究与验证的开源城市驾驶模拟器,提供可自由配置的传感器套件和环境条件。
项目介绍
CARLA 是一个面向自动驾驶研究的开源城市驾驶模拟器,用于开发、训练和验证自动驾驶系统。它不只提供模拟器代码和协议,还提供为此专门制作的开放数字资产(城市布局、建筑、车辆),并支持灵活配置传感器套件和环境条件。适合做感知、规划、控制实验的研究人员和工程师。
当前仓库是 Unreal Engine 5.8 版本的开发分支 ue58-dev,与 ue4-dev 分支的 UE 4.26 版本并存,两者差异较大,动手前需要确认哪个版本符合需求。项目还维护一组周边仓库:用于验证自动驾驶技术栈的 leaderboard、Scenario_Runner、ROS bridge、驾驶基准,以及强化学习和模仿学习代码。
构建与首次运行
硬件门槛较高:需要 Intel i7/i9 第 9–11 代或 AMD Ryzen 7/9、至少 32 GB 内存、RTX 3070/3080/3090/4090/5090 或更好且显存 16 GB 以上,系统为 Ubuntu 22.04 / 24.04 或 Windows 11;Ubuntu 20.04、Windows 10 及更早版本不受支持。
构建需要访问 CARLA 的 Unreal Engine 5.8 fork。先将 GitHub 账号与 Epic Games 关联,并准备好可下载 Unreal 仓库的 Git 凭据。
-
克隆分支:
git clone -b ue58-dev https://github.com/carla-simulator/carla.git CarlaUE5 -
Linux 下在仓库根目录运行交互式安装脚本。脚本会要求输入 sudo 密码安装依赖,并要求 GitHub 凭据下载 Unreal Engine:
cd CarlaUE5 ./CarlaSetup.sh --interactive无人值守安装需先导出
GIT_LOCAL_CREDENTIALS=username@github_token,再运行sudo -E ./CarlaSetup.sh。Windows 下运行CarlaSetup.bat,且暂不支持无人值守模式。 -
安装完成后用 CMake 配置并构建。Linux:
cmake -G Ninja -S . -B Build --toolchain=$PWD/CMake/Toolchain.cmake -DCMAKE_BUILD_TYPE=Release -DENABLE_ROS2=ON cmake --build BuildWindows 需在 Visual Studio 2022 的 x64 Native Tools Command Prompt 中执行配置,并去掉
-DENABLE_ROS2=ON。 -
安装 Python API 并启动编辑器:
cmake --build Build --target carla-python-api-install cmake --build Build --target launch
模拟器启动后的操作可参考首次使用指南,预编译版本见发布页,通过客户端控制仿真的接口见 Python API 文档。
使用约束与许可
构建会下载安装 Unreal Engine 5.8 和各类依赖,耗时长且占用大量磁盘空间。若要复用已有的 Python 3,安装脚本需传 --python-root,CMake 配置需设置 -DPython_ROOT_DIR 和 -DPython3_ROOT_DIR。Unreal Engine 5 使用自己的许可条款,与 CARLA 的许可分开。
CARLA 自有代码采用 MIT 许可,自有资产采用 CC-BY 许可。随附的第三方依赖各有许可证,包括 PROJ、SQLite、Xerces-C、Eigen,以及可选的 Autodesk FBX SDK。
HotRepo 点评
这是一个长期运行的研究平台,而不是能快速上手的演示:构建体量、Unreal Engine 账号要求和显卡下限共同决定了它的实际使用范围。2026-11-18 它在 C++ 日榜新增 27 星,并位列该榜第 5,说明 UE5 分支仍保持关注度;不过目前没有记录到全语言日榜名次。评估它是否适合现有自动驾驶工作流时,周边基准、ROS 和学习类仓库与模拟器本身同样重要。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。