Carla安装后第一件事：用Python脚本生成交通流和手动驾驶（避坑Python版本错误）-开发者社区

Carla安装后第一件事：用Python脚本生成交通流和手动驾驶（避坑Python版本错误）

当你第一次成功启动CarlaUE4编辑器窗口，看到空荡荡的城市街道时，那种兴奋感可能很快会被"接下来该做什么"的困惑取代。别担心，这正是大多数Carla新手都会经历的阶段。本文将带你快速上手两个最核心的Python示例脚本——generate_traffic.py和manual_control.py，让你在虚拟环境中轻松生成动态交通流并体验手动驾驶。

1. 为什么虚拟环境如此重要

很多开发者跳过虚拟环境直接运行脚本，结果遇到各种Python版本报错。Carla对Python版本有严格要求，不同版本的Carla需要特定Python版本支持。例如：

Carla版本	推荐Python版本	兼容性说明
0.9.14	3.7	最佳兼容
0.9.12	3.6-3.8	部分特性可能受限
最新开发版	3.8+	需查看官方文档

提示：使用conda list命令可以查看当前虚拟环境中安装的所有包及其版本

我曾在一个项目中因为忽略虚拟环境，浪费了两天时间排查各种依赖冲突。后来发现，只需一个简单的conda命令就能避免这些问题：

conda create -n carla_env python=3.7 conda activate carla_env

2. 准备运行环境：安装必要依赖

在运行示例脚本前，需要确保虚拟环境中安装了所有必要依赖。官方示例脚本通常需要以下核心包：

pygame：处理用户输入和可视化
numpy：数值计算基础
opencv-python：图像处理
matplotlib（可选）：数据可视化

安装这些依赖的最佳实践是使用requirements.txt文件：

cd PythonAPI/examples pip install -r requirements.txt

如果遇到网络问题，可以尝试以下替代方案：

使用国内镜像源：

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple -r requirements.txt

手动安装核心依赖：
```
pip install pygame numpy opencv-python
```

3. 生成动态交通流：generate_traffic.py详解

generate_traffic.py脚本是理解Carla交通系统的绝佳起点。它会自动生成车辆和行人，让空城变得生机勃勃。运行脚本的基本命令很简单：

python generate_traffic.py

但这个脚本背后有很多可定制的参数：

-n 30：设置生成的车辆数量（默认30）
-w 10：设置生成的行人数量（默认10）
--hybrid：启用混合物理模式
--seed 12345：设置随机种子，确保可重复性

注意：首次运行可能会较慢，因为Carla需要加载各种资源

实际项目中，我经常结合这些参数进行不同场景的测试：

# 生成50辆车和20个行人的繁忙交通场景 python generate_traffic.py -n 50 -w 20 # 生成10辆车的小规模测试场景 python generate_traffic.py -n 10 -w 0

4. 手动驾驶体验：manual_control.py深度探索

manual_control.py提供了最直观的Carla体验——让你亲自驾驶一辆车在城市中穿行。启动方式同样简单：

python manual_control.py

这个脚本支持丰富的控制方式：

键盘控制：

W/A/S/D：加速/左转/刹车/右转
Space：手刹
Q：切换倒车模式
M：自动挡/手动挡切换

鼠标控制：

移动鼠标：改变视角
左键点击：切换鼠标控制模式

脚本还包含一些隐藏功能，比如：

按T可以生成随机天气
按G切换交通信号灯状态
按B改变蓝图库

# 代码片段：manual_control.py中的关键控制逻辑 def keyboard_control(): if keys[K_w]: control.throttle = min(control.throttle + 0.01, 1) if keys[K_s]: control.brake = min(control.brake + 0.2, 1) if keys[K_a]: control.steer = max(control.steer - 0.05, -1) if keys[K_d]: control.steer = min(control.steer + 0.05, 1)

5. 常见问题与解决方案

即使按照步骤操作，仍可能遇到一些问题。以下是几个典型场景及其解决方法：

问题1：ModuleNotFoundError: No module named 'carla'

这表明Python环境没有正确安装Carla客户端库。解决方法：

# 定位到Carla的PythonAPI目录 cd PythonAPI/carla/dist pip install carla-*.whl

问题2：Python版本不匹配错误

如果看到类似"Python version X.X is required"的错误，说明当前Python环境版本不对。这时应该：

检查当前Python版本：
```
python --version
```

创建正确版本的conda环境：

conda create -n carla_py37 python=3.7 conda activate carla_py37

问题3：脚本运行但看不到任何车辆或行人

这通常是因为脚本没有正确连接到Carla服务器。确保：

CarlaUE4服务器正在运行
脚本和服务器在同一台机器上（或正确设置了IP）
端口号正确（默认2000）

6. 进阶技巧：自定义脚本体验

掌握了基础操作后，你可以尝试修改这些脚本来满足特定需求。例如，在manual_control.py中添加自定义功能：

修改车辆生成逻辑：

# 替换默认的Tesla Model 3为其他车型 blueprint_library = world.get_blueprint_library() vehicle_bp = blueprint_library.filter('model3')[0] # 改为： vehicle_bp = random.choice(blueprint_library.filter('vehicle.*'))

添加自定义HUD信息：

def render(self, display): # 在原有HUD基础上添加自定义信息 font = pygame.font.SysFont('Arial', 14) text = font.render(f'自定义信息: {self.speed:.1f} km/h', True, (255, 255, 255)) display.blit(text, (10, 10))

记录驾驶数据：

# 在控制循环中添加数据记录 with open('driving_log.csv', 'a') as f: f.write(f'{time.time()},{control.throttle},{control.steer}\n')

7. 性能优化建议

当场景变得复杂时，可能会遇到性能问题。以下是一些优化技巧：

调整画面质量：在CarlaUE4窗口按~打开控制台，输入：
```
r.SetRes 1280x720 r.PostProcessAAQuality 0
```

限制帧率：在Python脚本中添加：

settings = world.get_settings() settings.fixed_delta_seconds = 0.05 # 20 FPS world.apply_settings(settings)

选择性渲染：关闭不需要的传感器：
```
camera.destroy() # 当不需要摄像头时
```
使用低多边形地图：对于算法测试，可以使用Town07等简单地图：
```
./CarlaUE4.sh -quality-level=Low -carla-server -world-port=2000
```