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
小技巧: 装 Python 时,记得勾选 "Add Python to PATH"。省得后面手动配,麻烦。

4.2 使用预编译包快速上手

说实话,我不建议新手从源码编译。太慢了,而且容易出幺蛾子。用预编译包吧,省心。

步骤很简单:

  1. 去 Carla 官网的 GitHub Releases 页面,下载 CARLA_0.9.15.zip(版本号可能更新,选最新的稳定版就行)。
  2. 解压到一个路径不含中文和空格的文件夹。比如 D:\Carla。千万别放桌面,也别放带中文的路径,不然有你哭的。
  3. 双击 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 防火墙可能会弹窗问你要不要允许。记得点 "允许访问"。不然客户端连不上服务器。

避坑指南: 我曾经因为防火墙问题,折腾了一下午。后来发现只要把 CarlaUE4.exe 加到防火墙白名单里就行。具体操作:控制面板 → Windows Defender 防火墙 → 允许应用通过防火墙 → 添加 CarlaUE4.exe。

好了,Windows 上的环境搭建就这些。配好了,后面就顺了。配不好,每一步都是坑。不过别怕,按我说的来,稳得很。