第一次接触SUMO，是在做一个交叉路口信号配时的项目。当时项目组需要评估几种配时方案对车均延误的影响，市面上商业交通仿真软件要么报价感人，要么二次开发文档封闭。后来同事提到一个叫SUMO的开源交通仿真软件，说学术界做车路协同、信号优化、自动驾驶验证基本都靠它，而且完全免费。当时第一反应是不太敢信——免费的东西，能撑起这类科研级仿真需求？结果真正把SUMO装好、跑通第一个demo的时候，我才发现这工具比自己想象中能做的多得多，而网上关于"SUMO概述与安装配置"的教程，质量也是参差不齐。这篇就来聊聊SUMO是什么、怎么选型、以及我在Windows和Linux两套环境下安装配置的完整过程和踩坑总结。
1. SUMO概述与核心能力：先搞清它适合解决哪类交通问题
1.1 它到底是个什么级别的仿真软件
SUMO的全称是Simulation of Urban MObility，直译就是"城市交通仿真"，由德国宇航中心（DLR）主导开发，从2001年开源至今已经迭代了二十多年。我们知道交通仿真大体分宏观、中观、微观三层：宏观仿真把车流当成"流体"，适合大范围路网分析；微观仿真则把每一辆车都当成独立个体，有长度、有速度、有驾驶行为，能模拟跟驰、变道、信号灯响应。SUMO属于微观交通仿真，而且是目前开源领域里最主流、生态最完整的那一个。
它骨子里是个C++写的命令行引擎，所有核心功能都在sumo程序上跑，配合一个叫sumo-gui的图形界面用来可视化。除此之外，它不是一个孤立软件，而是一套工具链的组合，这也是SUMO和很多破解版商业软件最大的差异——它不是让你开个界面画个路网然后点播放，而是通过大量命令行工具把"路网构建—出行需求生成—仿真执行—结果分析"整条链路打通。
1.2 核心模块拆解：安装后你实际会用到哪些程序
装完SUMO之后，你会在bin目录下看到一堆可执行文件，对新手来说，先把下面这几个搞明白就够了：
| 程序名 | 作用 | 常见使用场景 |
|---|---|---|
| sumo | 无界面的仿真主程序，读取路网文件和出行需求文件，执行仿真计算 | 批量跑实验、后台仿真 |
| sumo-gui | 带图形界面的仿真程序，可在运行时实时查看车辆移动、信号灯变化 | 调试路网、观察仿真过程 |
| netconvert | 将其他格式的路网（OpenStreetMap、Shapefile等）转换为SUMO的.net.xml格式 | 从OSM导入真实路网 |
| netedit | 图形化路网编辑工具，可手动绘制道路、设置信号灯、增加检测器 | 从零建小型路网、修改局部路网 |
| duarouter | 根据出行需求（OD数据）计算车辆路径，生成.rou.xml车辆路由文件 | 生成仿真所需的车辆输入 |
| python/tools目录下的traci | Python接口，通过TraCI协议实时控制仿真中的车辆、信号灯 | 信号配时优化、车路协同算法验证 |
刚接触时最容易犯的错，是以为"安装SUMO"就是安装一个画图软件，双击图标开画。实际上建路网靠netedit或者netconvert，跑仿真靠sumo，改配置靠文本编辑器，全部是分离的。我见过不少新手在netedit里画了一下午路网，却不知道怎么跑起来，就是因为没搞清楚工具链的分工。
1.3 哪些场景真正用得上SUMO
作为交通仿真软件，SUMO的典型应用场景大致是这样几类：
一是传统交通工程里的信号配时优化和通行能力评估。把路口和路段画好，给定各方向的流量，跑几次仿真就能拿到车均延误、排队长度、通过量等指标，这比用理论公式算更接近真实情况。
二是车联网和自动驾驶算法的验证。因为SUMO支持TraCI实时控制，可以做到"仿真过程中随时读状态、下发指令"，很多V2X（车路协同）策略、自动驾驶决策逻辑都是在SUMO里先做闭环测试，再上真实场地。这是SUMO相对商业软件最大的亮点。
三是城市级大规模路网的研究。SUMO支持从OpenStreetMap直接拉取真实路网数据，再用轨迹数据、卡口数据标定OD，本身就有成熟的处理工具链，所以做城市拥堵分析、公交优先、限行措施评估也常用它。
四是教学和科研复现。因为开源，很多论文会给出SUMO的配置文件和脚本，别人搭好环境就能复现结果，这点对学术圈非常友好。
我自己的体会是：它最适合那种"需要自己写代码控制仿真、需要批量跑大实验、需要复现论文结果"的场景。如果只是做一个漂亮的动画给甲方看，SUMO的3D效果其实一般，不如商业软件直观。
2. 选择SUMO的考量：开源免费之外的几个关键理由
2.1 主流交通仿真软件横向对比
既然标题是概述与安装配置，选型这一段绕不开。我把主流几个工具放在一起对比过，结果大致如下：
| 工具 | 费用 | 仿真粒度 | 二次开发能力 | 典型场景 |
|---|---|---|---|---|
| VISSIM | 商业授权费高 | 微观 | 提供COM接口，但受许可证限制 | 商业项目、设计院 |
| TransModeler | 商业授权费高 | 宏观+微观混合 | 脚本能力有限 | 城市交通规划 |
| TransCAD | 商业授权费高 | 宏观 | 弱 | 交通规划四阶段法 |
| MATSim | 开源免费 | 中观/基于Agent | 强，Java | 大规模出行行为模拟 |
| SUMO | 开源免费 | 微观 | 极强，TraCI/XML | 信号优化、车路协同、算法验证、科研 |
从表中能看出来，SUMO在"微观仿真+强二次开发+零成本"这个交叉点上几乎是唯一的选择。MATSim虽然也是开源的，但它是活动链模型，更多用在宏观出行行为模拟，做不了一辆车在交叉口的跟驰变道细节。
2.2 我选SUMO而不是商业软件的决策逻辑
预算只是一个因素，但绝不是一个"省了多少钱"的问题。商业软件在项目交付和出图上确实省心，界面友好，动画漂亮，但你遇到任何一点定制需求，都会面临API文档封在人家官方论坛里、写邮件求技术支持、甚至要加钱买模块的困境。而SUMO的场景通常是这样：我需要在一段特定逻辑下反复修改信号配时，每跑一次就自动导出延误指标，还要画延误热力图——这套流程用TraCI加Python脚本完全自动化，跑10组方案也就几分钟的事。
另外，SUMO社区有一个特别好的习惯：几乎每个配置项、每个XML标签、每个Python函数都有完备的在线文档（SUMO官方文档每天还在更新），Stack Overflow上搜SUMO也有大量实战问答。对于一个需要长期深入研究的工具来说，这种生态带来的学习效率远比一套残缺的汉化教程高。
当然SUMO也有明显短板：3D可视化效果就那样，跑几万辆车的地图级仿真对内存和CPU要求高，建模需要学习XML配置体系和命令行工作流，前两三天上手会有些痛苦。但如果你本来就是做算法、做系统、做研究的，这点学习成本完全值得。
3. 安装前的环境准备：依赖与系统要求的实际建议
3.1 建议的系统与版本
SUMO官方同时发布Windows、Linux、macOS三个平台的版本。安装前建议先确认自己软件包的来源：用官方发布的预编译包，而不是随便找个绿色破解版，因为SUMO本身免费，没有破解概念，网上流传的"汉化版""完整版"反而是老版本或者有问题版本，容易踩坑。
我实际使用下来的配置建议是：
- Windows：Windows 10/11 64位均可，建议8GB内存以上，最好有固态盘。如果打算跑几十万辆车的大场景，16GB起步。
- Ubuntu/Debian：20.04或22.04比较稳，过大路网建议-i多核参数。
- 磁盘空间：安装只需要1-2GB，但路网缓存和仿真输出文件可能很快膨胀，记得预留10GB以上空间。
3.2 需要提前装好的间接依赖
安装SUMO本体之前，有几个间接依赖值得提前规划，虽然不是强制要求，但几乎每个能顺利跑通的人都会提前装好：
- Python 3.7以上。SUMO安装包的tools目录里有大量Python脚本，traci接口更必须有Python环境。Windows用户建议装官方Python并勾选"Add Python to PATH"，这一步不做好，后面终端执行python脚本会莫名报"python不是内部或外部命令"。
- Git（可选但推荐）。因为很多车辆路径生成、路网转换脚本、论文配套代码都以GitHub仓库形式存在，装好Git后可以随时拉取最新示例。
- C++运行库。Windows下部分版本需要VC++ Redistributable，如果运行sumo-gui时提示缺dll，多半是这个原因。
这些依赖本身不难装，跟网上那些JDK、Node.js、Maven的配置教程类似，核心就是记得把可执行文件目录加入PATH。
3.3 环境变量的两个基本概念
说到配置环境变量，这里必须用最简单的方法讲透，因为SUMO安装配置的坑有八成出在环境变量上。
第一个是PATH。当你打开一个终端敲sumo，系统会按PATH里记录的目录列表逐个去找sumo.exe或sumo可执行文件。如果bin目录没加进PATH，终端就会提示"无法识别sumo命令"。解决办法就是把SUMO安装目录下的bin路径加进去。
第二个是SUMO_HOME。这个变量表示SUMO安装的根目录，很多脚本和配置文件靠它定位安装路径下的资源文件（比如路网模板、脚本库）。如果SUMO_HOME没设对，运行python脚本时经常报"cannot find SUMO installation"。
这两个变量加好了，后面能省掉一堆神烦的报错。
4. Windows环境安装SUMO：完整流程与验证
4.1 如何获取安装包
Windows用户建议直接到SUMO官网的Downloads页面，或GitHub Releases页面下载官方打包好的Windows安装文件。当前主流版本是1.18.0、1.19.0、1.20.0这几个，新版本对.net.xml格式的兼容性整体没有大变化，但老配置在极个别字段上可能提示版本不匹配，所以选一个官网上标着"recommended"或者最新稳定版即可。
下载时会看到两个选项：一个是安装向导版（Setup.exe格式），一个是ZIP压缩包版。我的建议是下载安装向导版，因为它会自动帮你处理部分依赖注册。ZIP版适合绿色便携使用，但之后配置环境变量时路径容易带空格，对新手不太友好。
4.2 安装步骤与关键选项
双击安装文件，一路Next就好。有两处需要特别留意：
第一处是安装路径。强烈建议装到一个纯英文路径下，比如D:\SUMO\，而不是D:\软件\SUMO\。原因很简单：SUMO的XML配置和命令行工具在处理中文路径时可能出编码问题，到时候netconvert读不到文件、python脚本路径拼接报错，排查起来非常消耗耐心。
第二处是"Add SUMO to PATH"选项。新版安装向导里一般有这个勾选项，勾上后会帮你自动把bin目录加入用户PATH。如果没勾或者安装向导没有此选项（部分版本是有的），后面就得手动加。
安装完成后可以先看一眼安装目录结构，确认里面至少存在bin、tools、data、docs这些文件夹，bin里应该有sumo.exe、sumo-gui.exe、netconvert.exe、netedit.exe。
4.3 手动配置环境变量的正确姿势
如果安装向导没有自动配置环境变量，可以这样手动设置。
按Win+R输入sysdm.cpl打开系统属性，切到"高级"，点"环境变量"。有两种设置方式：
方式一是直接在用户变量里新建：
变量名: SUMO_HOME 变量值: D:\SUMO然后编辑用户变量里的Path，新建一项，填入D:\SUMO\bin。
方式二是命令行方式，两条命令搞定（注意setx设置的是持久值，但当前终端要重开才生效）：
setx SUMO_HOME "D:\SUMO" setx PATH "%PATH%;D:\SUMO\bin"我个人更推荐方式一，因为图形界面能看清楚已有路径，不容易把PATH搞乱。
设置完环境变量，还要记住一个细节：终端要重新打开，旧终端读不到新变量。Windows下经常有人配完发现没用，结果就是没开新窗口。
4.4 第一项验证：版本命令
配置完打开一个新的命令行窗口，依次执行：
sumo --version netconvert --version netedit --version如果每一条都能正常输出版本号，比如"SUMO Version 1.20.0"，就说明核心程序已经装好且PATH生效了。如果提示'sumo' 不是内部或外部命令，先别急着怀疑安装包，按以下顺序排查：
- 检查bin目录路径是否确实存在sumo.exe；
- 检查Path里是否出现过D:\SUMO\bin那一项；
- 关闭命令行窗口重新打开一次；
- 重启一次电脑再试。
另外，推荐顺手执行一下python --version，确认Python也正常工作，后面traci要用。
5. Linux下两种安装路线：apt和源码编译
5.1 Ubuntu用apt安装：适合快速上手
Ubuntu/Debian系最省事的安装方式是直接用apt：
sudo apt update sudo apt install sumo装完输入sumo --version，如果输出版本信息就成功了。apt安装版的bin目录通常在/usr/bin/sumo，tools目录通常在/usr/share/sumo/tools。然后设置环境变量：
export SUMO_HOME=/usr/share/sumo以上命令只在当前终端生效。想让每次登录都自动生效，就把它写进~/.bashrc：
echo 'export SUMO_HOME=/usr/share/sumo' >> ~/.bashrc source ~/.bashrc用apt装的优点是快，缺点是版本往往落后官方几代。我在Ubuntu 22.04上apt装到的版本经常是1.18.x甚至更低，而官方已经到1.20+。如果只是跑现成示例、学基本操作，apt的版本完全够用；但如果你想试用新版traci的新函数、或者跟论文里常用参数保持一致，建议走源码编译。
5.2 源码编译：需要定制最新功能时的标准路线
源码编译很简单，但耗时长，需要耐心。先安装编译依赖：
sudo apt install cmake g++ libxerces-c-dev libproj-dev libgl2ps-dev libfox-1.6-dev libgdal-dev然后克隆官方仓库：
git clone --recursive https://github.com/eclipse-sumo/sumo.git进入目录后：
cd sumo mkdir build && cd build cmake .. make -j$(nproc)编译时间取决于机器，一般10到30分钟。如果网络不好或者cmake阶段提示缺依赖，就用apt装对应-dev包后重试。编译完成后，可执行文件在build/bin目录，tools目录在sumo根目录。同样把这两处写进环境变量：
export SUMO_HOME=/path/to/sumo # sumo仓库根目录 export PATH=/path/to/sumo/build/bin:$PATH也可以写到~/.bashrc里持久化。
5.3 编译过程中常见的三板斧
源码编译最容易卡在依赖报错上。我遇到过几次，总结下来基本就是三个原因：
一是没装libxerces-c-dev，报错内容会包含xercesc/XercesDOMParser.h: No such file or directory，装对应包即可。二是openGL相关库缺失，cMake阶段提示找不到GL/gl.h，装libgl1-mesa-dev和libglu1-mesa-dev。三是git clone时没加--recursive，导致内部子模块（比如为OSM导入准备的文件）下载不全。记住这几个包名，能少走不少弯路。
6. 第一轮仿真测试：让SUMO真正跑起来
6.1 用官方示例做冒烟测试
装好工具、配好环境之后，别急着亲手画路网，先用官方自带示例跑一遍冒烟测试。SUMO安装目录的tools目录里通常有大量示例数据，在仓库里搜索*.sumocfg文件即可。比如在sumo/tests/sumo/中就有predator等经典示例。
在示例目录下执行：
sumo -c demo.sumocfg如果仿真正常结束，当前目录会生成tripinfo.xml、emissions.xml等输出文件。再用图形界面看一眼：
sumo-gui demo.sumocfg弹出的窗口里能看到车辆按路网行驶，右下角有仿真速度控制按钮。这一步能验证三件事：sumo引擎正常、sumo-gui可显示、配置文件语法能被当前版本解析。
6.2 从零画一个最简单的单路口路网
示例跑通后，真正能提升理解的做法是自己在netedit里画一个最小路网。打开netedit，选择创建道路工具，画一条横向道路和一条纵向道路并让它们交叉，再用"连接"工具建立转向连接，最后给路口设置信号灯或在交叉口增加让行规则。
保存时netedit会要求你给网络文件取名，比如test.net.xml，再手写或让netedit生成一个最简单的车辆配置。最省事的做法是参照官方文档中的hello world示例，准备两个文件：
test.rou.xml：
<routes> <vType id="car" accel="2.0" decel="4.5" maxSpeed="16.67" color="1,0,0"/> <vehicle id="v0" type="car" depart="0" route="r0"/> <route id="r0" edges="e0 e1"/> </routes>以及test.sumocfg：
<configuration> <input> <net-file value="test.net.xml"/> <route-files value="test.rou.xml"/> </input> <output> <tripinfo-output value="tripinfo.xml"/> </output> </configuration>在netedit里把边命名为e0和e1，保证route里写的边id和路网里的实际id一致。然后执行：
sumo-gui test.sumocfg如果一辆红色小车从e0驶入、在交叉口转向后从e1驶出，说明你的路网、路由和仿真链路全部跑通了。这一步是往后所有复杂仿真实验的基础，一定要亲手过一遍。
6.3 用TraCI完成一次"程序控制仿真"
SUMO的一个核心卖点就是TraCI。验证它是否可用很简单，在Python里执行：
import traci traci.start(["sumo-gui", "-c", "test.sumocfg"]) step = 0 while step < 500: traci.simulationStep() step += 1 traci.close()如果脚本正常跑完，说明本机traci可用。配合前面提到的SUMO_HOME环境变量，许多tools脚本（比如分流、转路网数据的python工具）才能正常工作。我第一次在Windows上跑traci时遇到ModuleNotFoundError，检查后发现是SUMO_HOME没设置，tools目录下的脚本找不到traci模块。
7. 安装配置阶段的高频问题排查
7.1 环境变量类问题：九成安装失败的根源
把所有类似的报错归纳一下：'sumo' 不是内部或外部命令、sumo: command not found、Error: cannot find SUMO_HOME、ModuleNotFoundError: No module named 'traci'。这类问题基本只跟环境变量有关，排查顺序就三步：
- 终端里执行
echo %SUMO_HOME%或echo $SUMO_HOME，确认变量是否存在； - 执行
echo %PATH%或echo $PATH，确认bin路径是否在列表里； - 重新打开终端，再次测试。
Windows下特别要注意Path里每一段路径的间隔符是分号，Linux是冒号，修改错误会导致整个PATH读取混乱。
7.2 netedit或sumo-gui启动就崩溃
图形界面打不开，Windows下最常见的原因是缺少VC++运行时或OpenGL驱动问题。先尝试安装微软官方的VC++ Redistributable包，再更新显卡驱动。Linux下通常是OpenGL相关库没装，执行sudo apt install freeglut3-dev libglu1-mesa-dev后重试。
还有一种情况是窗口一闪而过，什么都没提示。这时回到命令行执行sumo-gui，会看到具体的error输出，多半指向某个配置文件路径写错或者缺文件。
7.3 版本与配置文件的兼容坑
SUMO对配置项的解析很严格，老版本产生的.net.xml用新版sumo跑，有时会出现不可识别的属性警告，有些只是warning，有些会直接导致加载失败。解决办法是用当前版本的netconvert或netedit把老文件重新转换、另存一遍。这个操作很机械，但能消除大量莫名其妙的version报错。
另外要注意路径中的空格和中文字符。Windows下很多人习惯把项目文件放在"桌面/新建文件夹"这类路径里，SUMO的配置解析有时会对空格敏感，轻则警告，重则读取失败。最稳妥的统一约定是：所有SUMO相关文件都放在纯英文无空格路径下。
7.4 网络类查询与依赖下载的通用提醒
最后说一个新手很容易忽略的点：SUMO从官方源或GitHub下载依赖和示例时，网络环境会直接影响成功率。如果你在拉取子模块时经常失败，可以尝试设置Git的代理或不使用--recursive分步拉取。但请注意，整个过程请始终使用官方渠道（eclipse-sumo官方GitHub仓库、官网Download页面），不要迷信来路不明的"集成包"。
实际使用后的几点提醒
走完整个安装配置流程之后，最想对刚入门的读者说的其实是：安装SUMO不是为了装一个软件，而是为了建立一套工作流。很多人在环境变量里折腾一两个小时没跑通，第二天就不想碰了，但只要把第一章示例完整跑一遍，后面无论做信号控制还是车路协同，都会顺畅很多。建议新手先花一个下午把官方Tutorials目录下的hello world和TraCI入门过一遍，再回到自己课题里建模，这是最快的路径。
如果在安装配置阶段你卡在了某个报错上，多半不是你的操作问题，而是依赖不全或版本错位。把报错信息完整复制出来去官方文档或GitHub issues搜索，比在任何地方问"怎么装SUMO"更高效。我自己当初编译源码时遇到一个libproj版本不符的报错，最后就是在GitHub issues里找到的解决方案。这工具看着复杂，但每往前一步，后面能做的实验范围就大一圈。希望这篇"SUMO概述与安装配置"能帮你把第一步迈过去。
