4、环境搭建(Windows):Windows系统要求与依赖安装、使用预编译包快速上手、配置环境变量与Python路径、常见Windows兼容性问题。
好,咱们开始动手了。Windows 上搭 Carla,说难不难,说简单吧,坑也不少。我当年第一次装的时候,光环境变量就折腾了半小时。别急,跟着我的节奏来,咱们一步步搞定。
4.1 Windows 系统要求与依赖安装
先看看你的电脑够不够格。Carla 这玩意儿,说白了就是个吃配置的大家伙。
| 组件 | 最低要求 | 推荐配置 |
|---|---|---|
| 操作系统 | Windows 10 64-bit | Windows 11 64-bit |
| CPU | Intel i5 4代 / AMD Ryzen 3 | Intel i7 8代 / AMD Ryzen 5 以上 |
| 内存 | 8 GB | 16 GB 或更高 |
| 显卡 | NVIDIA GTX 960 / AMD R9 280 | NVIDIA RTX 2060 或更高 |
| 显存 | 4 GB | 6 GB 或更高 |
| 硬盘 | 20 GB 可用空间 | SSD + 50 GB 可用空间 |
| DirectX | DirectX 12 | DirectX 12 |
嗯,这里要注意。显卡驱动一定要更新到最新版。我遇到过有人拿着老驱动跑 Carla,结果画面全是马赛克,还以为是显卡坏了。
依赖安装其实不复杂。你需要装这几个东西:
- Visual Studio 2022 运行库:去微软官网下个 vc_redist.x64.exe,装上就行。
- .NET Framework 4.8:Windows 10 一般自带,没有的话去更新一下。
- Python 3.8.x:注意,别装 3.9 或 3.10,Carla 对 Python 版本很挑。我个人习惯用 3.8.10。
- pip 和 setuptools:装完 Python 后,打开命令行跑一下
python -m pip install --upgrade pip setuptools。
4.2 使用预编译包快速上手
说实话,我不建议新手从源码编译。太慢了,而且容易出幺蛾子。用预编译包吧,省心。
步骤很简单:
- 去 Carla 官网的 GitHub Releases 页面,下载
CARLA_0.9.15.zip(版本号可能更新,选最新的稳定版就行)。 - 解压到一个路径不含中文和空格的文件夹。比如
D:\Carla。千万别放桌面,也别放带中文的路径,不然有你哭的。 - 双击
CarlaUE4.exe,等一会儿,看到那个熟悉的小镇画面,就说明成了。
我第一次跑起来的时候,心里还挺激动的。你想想看,一个虚拟世界就在你眼前展开了。不过别高兴太早,后面还有环境变量要配。
4.3 配置环境变量与 Python 路径
这一步很多人会栽跟头。说白了,就是让系统知道 Carla 在哪,Python 在哪。
先配 Python 路径。打开系统环境变量设置:
- 右键 "此电脑" → "属性" → "高级系统设置" → "环境变量"。
- 在 "系统变量" 里找到
Path,双击编辑。 - 添加 Python 安装路径,比如
C:\Users\你的用户名\AppData\Local\Programs\Python\Python38。 - 再添加
C:\Users\你的用户名\AppData\Local\Programs\Python\Python38\Scripts。
然后配 Carla 的 Python API 路径。Carla 解压后,有个 PythonAPI\carla 文件夹。把它的完整路径加到 Path 里。比如 D:\Carla\PythonAPI\carla。
为什么要配这个?因为你要在 Python 里 import carla。不配路径,Python 找不到这个模块。我当年就是忘了这步,折腾了半天才发现。
验证一下。打开命令行,输入:
python -c "import carla; print(carla.__version__)"
如果输出版本号,比如 0.9.15,那就对了。如果报错 ModuleNotFoundError,说明路径没配好,回去检查。
4.4 常见 Windows 兼容性问题
Windows 上跑 Carla,问题还真不少。我挑几个常见的说说。
问题一:CarlaUE4.exe 闪退
这个最常见。原因一般是显卡驱动太老,或者 DirectX 版本不对。解决办法:
- 更新显卡驱动到最新版。
- 确保系统装了 DirectX 12。
- 如果还不行,试试用
-dx11参数启动:在命令行里跑CarlaUE4.exe -dx11。
问题二:Python API 报错
比如 ImportError: DLL load failed。这通常是 Python 版本不匹配。Carla 0.9.15 只支持 Python 3.8.x。你装个 3.9 或 3.10,就会出这问题。我曾经帮一个同事排查了半天,最后发现他装的是 Python 3.11。嗯,换回 3.8 就好了。
问题三:路径含中文或空格
Carla 对路径很敏感。如果你把 Carla 解压到 D:\自动驾驶\Carla 项目,那大概率跑不起来。解决办法:换个纯英文路径,比如 D:\Carla。
问题四:防火墙拦截
Carla 启动时会监听一些端口。Windows 防火墙可能会弹窗问你要不要允许。记得点 "允许访问"。不然客户端连不上服务器。
好了,Windows 上的环境搭建就这些。配好了,后面就顺了。配不好,每一步都是坑。不过别怕,按我说的来,稳得很。