Windows 环境下安装 SUMO 的完整教程：从下载安装到环境配置，一次搞定

关键词：Windows 安装 SUMO、SUMO 环境配置、SUMO 仿真软件安装、Windows 下配置 SUMO

SUMO（Simulation of Urban MObility）是一款很常用的交通仿真软件，很多做智能交通、车联网、自动驾驶仿真、路网研究的人都会用到。它本身功能很强，但在 Windows 上安装时，很多人会卡在路径配置、Python 接口、依赖库、环境变量这几步。
这篇文章就按新手也能看懂的方式，把 Windows 环境下安装 SUMO 的全过程讲清楚，包括基础安装、环境变量配置、Python 接口测试、常见问题排查。

一、安装前先搞清楚：SUMO 是什么，适合谁用

SUMO 全称是 Simulation of Urban MObility，它是一个开源交通仿真平台，主要用来模拟：

车辆通行
路网流量
信号灯控制
行人出行
车联网通信
智能交通策略验证

它的特点是：

免费开源
跨平台
支持命令行和图形界面
可以和 Python 联动
适合科研、教学、项目开发

如果你是：

刚接触交通仿真的人
做论文实验的人
搭建车路协同环境的人
想把 SUMO 接到 Python 项目里的人

那这篇教程基本就能覆盖你的安装需求。

二、安装前准备工作

在 Windows 上装 SUMO，建议先准备好下面这些东西：

1. 系统要求

一般 Windows 10 / Windows 11 都可以正常安装。
建议系统是：

Windows 10 64 位
Windows 11 64 位

2. 需要安装的软件

最好提前准备：

SUMO 安装包
Python 3.x
文本编辑器或 IDE，比如 VS Code、PyCharm
可选：Java、Git

其中最重要的是 Python，因为很多人后面都要用 traci、sumolib 这些接口。

三、下载 SUMO 安装包

方法 1：官网下载最新版

直接去 SUMO 官方网站下载 Windows 安装包。一般会提供：

.exe 安装程序
.zip 压缩包版本

新手建议直接装 .exe 版本，最省事。

方法 2：下载压缩包便携版

如果你不想安装，或者想自己控制路径，也可以下载 .zip 版本，解压后直接用。
这个适合：

电脑权限受限
想放到非系统盘
想做多版本切换

四、Windows 下安装 SUMO 的详细步骤

下面以 安装版 为例说明。

第一步：运行安装程序

双击下载好的 SUMO-xxx.exe 文件，开始安装。

安装过程中一般会出现这些选项：

安装路径
是否创建快捷方式
是否添加环境变量
组件选择

第二步：选择安装路径

建议不要装在系统盘深层目录里，最好放到一个清晰的路径，比如：

D:\Program Files\Sumo

或者：

E:\Tools\SUMO

这样后面查找文件、配置环境变量都更方便。

第三步：勾选核心组件

安装时如果有组件选择，建议保留这些：

sumo
sumo-gui
tools
examples

其中：

sumo：命令行仿真程序
sumo-gui：图形界面程序
tools：脚本工具
examples：示例文件

第四步：完成安装

安装完成后，先不要急着关掉，最好记一下安装目录。
后面配置环境变量会用到。

五、配置环境变量：这是最关键的一步

很多人装完 SUMO 之后，命令行里直接输入 sumo 提示找不到，这通常就是环境变量没配好。

1. 找到 SUMO 安装目录

比如你安装在：

D:\Program Files\Sumo

那么需要关注的通常是这个目录下的：

D:\Program Files\Sumo\bin
D:\Program Files\Sumo\tools

2. 配置系统环境变量

按下面步骤操作：

右键“此电脑”
点击“属性”
进入“高级系统设置”
点击“环境变量”
在“系统变量”里找到 Path
点击“编辑”
点击“新建”
把 SUMO 的 bin 路径加进去

例如：

D:\Program Files\Sumo\bin

如果你要在 Python 中使用 SUMO，还建议把 tools 也加进去：

D:\Program Files\Sumo\tools

3. 设置 `SUMO_HOME`

这个变量对 Python 接口很有用。

在“系统变量”里新建：

变量名：SUMO_HOME
变量值：你的 SUMO 安装目录

例如：

D:\Program Files\Sumo

4. 检查是否配置成功

打开命令提示符 cmd，输入：

sumo --version

如果显示版本信息，说明配置成功。

也可以试试：

sumo-gui --version

如果都能正常输出，说明 SUMO 已经能被系统识别了。

六、安装 Python 并配置 SUMO 的 Python 接口

很多 SUMO 项目最终都会用到 Python，所以这一步很重要。

1. 安装 Python

建议安装 Python 3.8 以上版本，常见可用版本包括：

Python 3.8
Python 3.9
Python 3.10
Python 3.11

安装时记得勾选：

Add Python to PATH

这样后面就能直接在命令行里用 python 和 pip。

2. 检查 Python 是否成功安装

打开 cmd，输入：

python --version

再输入：

pip --version

如果能正常显示版本号，说明 Python 已经装好。

3. 配置 SUMO 的 Python 路径

SUMO 的 Python 工具一般在 tools 目录里，比如：

D:\Program Files\Sumo\tools

如果你写 Python 脚本，要在代码里加入这段：

import os
import sys

if 'SUMO_HOME' in os.environ:
    tools = os.path.join(os.environ['SUMO_HOME'], 'tools')
    sys.path.append(tools)
else:
    sys.exit("请先设置 SUMO_HOME 环境变量")

这段代码的作用是让 Python 找到 SUMO 自带的工具包，比如：

traci
sumolib

七、安装 SUMO 的 Python 依赖包

有些项目需要额外的 Python 包，建议先装好常用依赖。

基础依赖

可以先执行：

pip install numpy matplotlib

如果你要做更复杂的仿真控制，可以按需求安装：

pip install pandas
pip install scipy
pip install networkx

检查 `traci` 是否能导入

打开 Python 交互环境，输入：

import traci
import sumolib

如果没有报错，说明 Python 接口已经通了。

八、测试 SUMO 是否安装成功

安装完以后，最好做一次完整测试，确认软件真的能用。

方法 1：测试命令行版本

在 cmd 里输入：

sumo --version

如果输出版本号，说明主程序正常。

方法 2：测试图形界面

输入：

sumo-gui

如果能打开图形窗口，说明 GUI 没问题。

方法 3：运行官方示例

SUMO 安装目录下通常有 examples 文件夹。
你可以找一个示例工程，运行里面的配置文件，比如：

sumo-gui -c your_example.sumocfg

如果图形界面能正常加载路网和车辆，就说明整个环境已经通了。

九、常见问题与解决办法

这一部分最实用，因为很多人装完之后并不是“没装上”，而是“装上了但不能用”。

问题 1：命令行提示“sumo 不是内部或外部命令”

原因

通常是环境变量没加对。

解决办法

检查这两个地方：

Path 中是否包含 SUMO\bin
SUMO_HOME 是否正确设置

例如：

D:\Program Files\Sumo\bin

设置完后，重新打开 cmd 再测试，不要在旧窗口里继续试。

问题 2：Python 提示找不到 `traci`

原因

Python 没有找到 SUMO 的 tools 路径。

解决办法

确认代码中有这段：

import os
import sys

if 'SUMO_HOME' in os.environ:
    tools = os.path.join(os.environ['SUMO_HOME'], 'tools')
    sys.path.append(tools)

同时确认 SUMO_HOME 设置正确。

问题 3：`sumo-gui` 打不开，闪退或者报错

原因

可能是显卡兼容、路径问题、运行库缺失，或者安装包不完整。

解决办法

按顺序排查：

先用命令行运行：
```
sumo-gui
```
换一个较新的 SUMO 版本
检查安装路径是否有中文或特殊符号
尽量不要装在桌面、下载目录这类不稳定位置
以管理员身份运行试试

问题 4：运行示例时报找不到文件

原因

配置文件路径写错，或者当前工作目录不对。

解决办法

建议使用绝对路径，例如：

sumo-gui -c D:\SUMO_Project\example\test.sumocfg

不要只写文件名，除非你已经切换到正确目录。

问题 5：安装后版本太旧，不想重装

解决办法

如果你下载的是压缩包版本，直接换一个新版本解压即可。
如果是安装版，建议卸载旧版后重装新版本。

为了避免混乱，最好：

一个版本对应一个目录
只保留一个主用版本
环境变量不要乱指向多个 SUMO 目录

十、推荐的安装方式：新手和进阶用户怎么选

新手建议

如果你是第一次接触 SUMO，建议这样做：

下载官方 Windows 安装版
安装到非系统盘
配置 Path 和 SUMO_HOME
安装 Python
测试 sumo --version
再测试 Python 接口

这种方式最稳，出问题也方便排查。

进阶用户建议

如果你经常切换版本，或者做科研项目，建议：

下载压缩包版本
手动配置环境变量
使用独立 Python 虚拟环境

比如你可以创建虚拟环境：

python -m venv sumo_env

激活后再安装需要的包，这样项目之间不会互相干扰。

十一、一个最小可用的 SUMO + Python 测试脚本

如果你想确认整个环境真的通了，可以用下面这个简单脚本测试。

import os
import sys

if 'SUMO_HOME' in os.environ:
    tools = os.path.join(os.environ['SUMO_HOME'], 'tools')
    sys.path.append(tools)
else:
    sys.exit("请先设置 SUMO_HOME")

import traci
import sumolib

print("SUMO Python 环境正常")
print("SUMO_HOME =", os.environ['SUMO_HOME'])