跳到主要内容 Ubuntu 22.04 源码编译安装 CARLA 0.9.15 教程 | 极客日志
C++ AI
Ubuntu 22.04 源码编译安装 CARLA 0.9.15 教程 详细介绍了在 Ubuntu 22.04 上从源码编译安装 CARLA 0.9.15 及其依赖 Unreal Engine 4.26 的全过程,包括系统准备、依赖安装、编译步骤及最终验证方法。
PentesterX 发布于 2026/2/16 更新于 2026/4/18 3 浏览🚀 Ubuntu 22.04 源码编译安装 CARLA 0.9.15 教程
随着自动驾驶研究的深入,CARLA 模拟器成为了必不可少的工具。相比于直接下载预编译版,源码编译版 (Build from source) 允许我们修改服务器端代码、自定义传感器以及集成新的地图和资产。
本文将详细介绍如何在 Ubuntu 22.04 系统下,从零开始编译安装 CARLA 0.9.15 及其依赖的 Unreal Engine 4.26 。
🛠️ 一、 硬件与系统准备
在开始之前,请确保你的机器满足以下要求,否则编译过程大概率会失败:
磁盘空间 :至少 150GB 空闲空间(编译UE4和CARLA会产生大量中间文件)。
内存 :建议 32GB RAM 。
显卡 :推荐 6GB 显存以上的 NVIDIA 显卡,并已安装好驱动。
1.1 安装基础依赖 sudo apt-get update && sudo apt-get install wget software-properties-common && sudo add-apt-repository ppa:ubuntu-toolchain-r/test && wget -O - https://apt.llvm.org/llvm-snapshot.gpg.key | sudo apt-key add -
1.2 安装兼容性配置 sudo apt-add-repository "deb http://archive.ubuntu.com/ubuntu focal main universe"
sudo apt-get update
sudo apt-get install build-essential clang-10 lld-10 g++-7 cmake ninja-build libvulkan1 python python3 python3-dev python3-pip libpng-dev libtiff5-dev libjpeg-dev tzdata sed curl unzip autoconf libtool rsync libxml2-dev git git-lfs
sudo update-alternatives --install /usr/bin/clang++ clang++ /usr/lib/llvm-10/bin/clang++ 180 && sudo update-alternatives --install /usr/bin/clang clang /usr/lib/llvm-10/bin/clang 180 && sudo update-alternatives --install /usr/bin/g++ g++ /usr/bin/g++-7 180
1.3 配置 Python 依赖 建议使用 Conda 管理 Python 环境,避免污染系统环境。
pip install --user setuptools && pip3 install --user -Iv setuptools==47.3.1 && pip install --user distro && pip3 install --user distro && pip install --user wheel && pip3 install --user wheel auditwheel
🎮 二、 编译 Unreal Engine 4.26 CARLA 是基于虚幻引擎(Unreal Engine)开发的,我们需要使用 CARLA 官方 fork 的特定版本 UE4。
2.1 获取源码权限
如果未关联,访问下面的仓库链接会显示 404 错误。
2.2 克隆仓库
cd ~
git clone --depth 1 -b carla https://github.com/CarlaUnreal/UnrealEngine.git ~/UnrealEngine_4.26
2.3 编译引擎 这一步耗时较长(取决于网速和CPU核心数),请耐心等待。
cd ~/UnrealEngine_4.26
./Setup.sh
./GenerateProjectFiles.sh
make
提示 :如果 ./Setup.sh 下载速度过慢,请检查网络环境,或自行配置代理。
2.4 验证安装 cd ~/UnrealEngine_4.26/Engine/Binaries/Linux && ./UE4Editor
如果成功弹出了虚幻引擎的编辑器窗口,说明 UE4 安装成功。关闭窗口继续下一步。
🚗 三、 编译 CARLA 0.9.15
3.1 克隆 CARLA 源码 cd ~
sudo apt-get install aria2
git clone -b 0.9.15 https://github.com/carla-simulator/carla
cd carla
3.2 下载资源包 (Content) 修改 Update.sh 文件,大约在第50行
原来的:
CONTENT_LINK =http://carla-assets.s3.amazonaws.com/${CONTENT_ID} .tar.gz
CONTENT_LINK =https://carla-assets.s3.us-east-005 .backblazeb2.com/${CONTENT_ID} .tar.gz
Download aborted. URI=http://carla-assets.s3.amazonaws.com/20221201_5ec9328.tar.gz Exception: [AbstractCommand.cc:351] errorCode=3 URI=http://carla-assets.s3.amazonaws.com/20221201_5ec9328.tar.gz -> [HttpSkipResponseCommand.cc:218] errorCode=3 Resource not found
之后执行如下指令,CARLA 需要下载约几 GB 的资产包。
3.3 设置环境变量 告诉 CARLA 你的 UE4 安装在哪里。打开 ~/.bashrc 添加:
export UE4_ROOT=~/UnrealEngine_4.26
3.4 编译 CARLA 分为两个主要步骤:编译 Python API 和 编译服务器。
定位到CARLA源代码目录下的 Util/BuildTools/Setup.sh 文件
找到大约第94行的 Boost 下载命令
将原有的下载地址:
wget "https://boostorg.jfrog.io/artifactory/main/release/${BOOST_VERSION} /source/${BOOST_PACKAGE_BASENAME} .tar.gz" || true
wget "https://archives.boost.io/release/${BOOST_VERSION} /source/${BOOST_PACKAGE_BASENAME} .tar.gz" || true
Setup.sh: Extracting boost for Python 3 .
gzip: stdin: not in gzip format
tar: Child returned status 1
tar: Error is not recoverable: exiting now
make: *** [Util/BuildTools/Linux.mk:142: setup ] Error 2
LIBPNG_REPO =https: //sourceforge.net/projects /libpng/files /libpng16/ ${ LIBPNG_VERSION }/libpng-${ LIBPNG_VERSION }.tar.xz
LIBPNG_REPO=https://sourceforge.net/projects/libpng/files/libpng16/older-releases/${LIBPNG_VERSION} /libpng-${LIBPNG_VERSION} .tar.xz
成功后,会在 PythonAPI/carla/dist/ 下生成 .egg 或 .whl 文件。
2. 编译服务器 (Launch)
这一步会将 CARLA 导入到 UE4 编辑器中并进行编译。
首次运行 make launch 会非常慢,因为它需要编译着色器(Shaders)和构建 C++ 类。成功后,UE4 编辑器会自动打开,并加载了 CARLA 的工程。
🕹️ 四、 运行与测试 打开一个新的终端,激活你的 Python 环境,运行示例脚本:
cd PythonAPI/examples
python3 -m pip install -r requirements.txt
python3 generate_traffic.py
cd PythonAPI/examples
python3 dynamic_weather.py
如果场景里出现了会动的小车,恭喜你!CARLA 0.9.15 源码编译安装成功!🎉
微信扫一扫,关注极客日志 微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
相关免费在线工具 RSA密钥对生成器 生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
Mermaid 预览与可视化编辑 基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
Base64 字符串编码/解码 将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
Base64 文件转换器 将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
Markdown转HTML 将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online
HTML转Markdown 将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online