1. 为什么选SUMO开源交通仿真的定位与优势1.1 那些年我们用过的交通仿真工具如果你是在校学生、科研人员或者刚进入智能交通、自动驾驶测试领域的从业者第一次接触交通仿真时大概率会被一堆名词绕晕VISSIM、TransModeler、Aimsun、MATSim、SUMO……商业软件确实功能全面、界面友好但动辄几十万甚至上百万的授权费用不是每个课题组和创业团队都能轻松承担的。开源的MATSim更偏向宏观层面的出行需求建模和传统意义上的“路网级微观仿真”其实并不完全是一回事。SUMOSimulation of Urban MObility的定位恰好卡在一个非常实用的位置它是一款开源、微观、空间连续的交通仿真工具由德国航空航天中心DLR主导开发从2001年发布至今已经迭代了二十多年。所谓“开源”意味着你不需要向学校申请软件采购预算不用注册企业邮箱等审批官网直接下载解压就能用所谓“微观”意味着每一辆车都有自己的跟驰模型、换道逻辑、信号响应行为不像宏观模型那样只关心流量密度关系所谓“空间连续”意味着车辆在路网中的位置是精确到米和秒的不是格子化的抽象模拟。这个定位让SUMO在学术界和工业界都积累了庞大的用户基础。Web of Science上搜SUMO相关的论文有个几千篇不夸张很多自动驾驶仿真平台比如CARLA的某些协同方案也会把SUMO作为底层交通流生成器。所以从这个角度说花时间去学SUMO不是学一个“小众工具”而是在掌握一套行业内相当通用的基础设施。1.2 SUMO能干什么什么场景真的需要它网上关于SUMO的教程不少但很多都停留在“能跑通演示”的层面读完并不知道自己能拿它做什么。我个人理解SUMO的价值集中在下面几个场景你可以对号入座路网建模与信号控制优化把真实城市道路的交叉口、车道、信号配时录入SUMO仿真不同配时方案下的平均延误、排队长度量化对比优化效果。这在交通工程专业的毕业设计里特别常见。自动驾驶与网联车V2X测试SUMO支持TraCI协议Python脚本可以在仿真运行过程中实时控制车辆的加速、减速、变道、驶入驶出相当于一个开放的“交通流沙盘”。你可以在里面模拟各种极端场景比如一辆车突然急刹导致后方连锁反应然后验证你的控制算法是否能有效缓解。多模式交通仿真SUMO不只是小汽车行人、自行车、公交车、轨道车辆都可以建模。研究“最后一公里”接驳、公交优先信号、慢行交通影响时这些功能非常关键。与真实数据对接的复现实验通过OD矩阵、路口流量检测数据反推路网需求在SUMO里重建一个片区的交通运行状态用来评估新道路开通、施工管制等方案的影响。如果你只是需要一个好看的“仿真动画”放在PPT里SUMO的默认3D效果确实不如商业软件它的核心优势在于可编程、可批量实验、可复现——一句话是做研究的好工具。这篇教程是整个系列的第一篇先把Windows 10上的安装环境彻底搞定后面所有关于路网构建、车辆输入、信号控制、TraCI操作的内容才能顺利展开。2. 安装前的环境准备别急着双击安装包2.1 先确认系统条件Windows 10真的“都可以”吗SUMO官方对Windows的支持其实一直比较低调很多文档默认用户在Linux上跑。但实际情况是绝大多数国内的学生和工程师主力机就是Windows所以在Windows 10上把环境彻底配好完全可行而且我用下来稳定性并不差。官方发布页面会提供Windows的二进制安装包不需要自己编译这一步就省去了大量麻烦。系统方面Windows 10的64位版本是当前支持最好的目标环境。32位系统我不建议尝试因为新版SUMO的预编译包基本只提供64位而且内存寻址限制在仿真规模稍大时会非常痛苦。Windows 10家庭版、专业版、教育版、企业版其实没本质区别关键看系统版本号是否比较新。如果你还在用早期的Windows 10版本比如1507、1511那种老古董建议先把系统更新到20H2或更高因为新版SUMO的运行库依赖可能要求较新的系统组件。硬盘和内存没什么苛刻要求安装包大约100多MB解压后占用空间也就200MB到300MB级别。但请注意SUMO仿真跑起来后路网文件和输出文件都挺占空间的如果以后要跑大规模区域仿真C盘至少留出5GB以上的余量比较稳妥。内存方面仿真几千辆车时1GB~2GB内存就够但如果你跑几万辆车的区域仿真加轨迹输出16GB内存是起步价。另外提醒一个容易翻车的小地方如果你之前安装过其他交通仿真软件比如VISSIM、Aimsun它们可能会修改系统Path、注册表或者安装证书服务这些一般不会和SUMO冲突但如果你遇到SUMO启动后弹奇怪的DLL错误先想想是不是杀毒软件把某些文件隔离了。Windows Defender有时会对刚下载的exe安装包报“不常见程序”的警告这不是病毒但你需要手动选择“仍要运行”。2.2 Python环境装不装装哪个版本如果你是第一次接触交通仿真可能会疑惑装一个仿真软件为什么教程里还要先装Python答案很简单SUMO的图形界面sumo-gui确实能完成手动建路网、跑仿真、看动画这些基础操作但真正让SUMO强大的是它的Python接口——TraCI和SumoLib。TraCITraffic Control Interface允许你在仿真运行过程中用Python实时读取车辆状态、修改信号灯、注入新车辆相当于在仿真世界里伸进去一只手。SumoLib则是更高层的异步接口适合批量跑实验。这两者的前提是Python环境能正确导入SUMO的相关包。版本选择上建议直接装Python 3.8到3.11之间的版本。SUMO的traci包对Python版本兼容性做得还行太老的3.6、3.7也不至于装不了但没必要给自己挖坑。官方文档目前推荐的还是稳定版本3.10左右实测兼容性最好。下载地址就是python.org官方不要去第三方站点下“优化版”“绿色版”那些打包来源不明出了问题排查起来非常头疼。安装Python时有一个必须勾选的选项Add Python to PATH。很多人第一次装的时候忽略了这个导致后来在命令行里敲python没反应还要去手动配环境变量绕了一圈。如果你之前已经装过Python不确定是否勾选了这个选项最简单的验证方法是打开CMD按WinR输入cmd回车然后敲python --version。如果输出版本号说明环境OK如果提示“不是内部或外部命令”那你需要在“系统属性-环境变量-Path”里手动添加Python的安装目录比如C:\Users\你的用户名\AppData\Local\Programs\Python\Python310\和同目录下的Scripts子文件夹。顺带一个经验Python安装时不要勾选Install for all users吗不我建议就保持默认的“Install Now”就行它默认装到当前用户的目录下不会碰系统保护区域后续要卸载也干净。管理员权限不是必需的除非你非要装到C:\Program Files里。3. 正式安装SUMO在Windows 10上的完整步骤3.1 去哪里下别下错版本SUMO的官网是sumo.dlr.de不过有时国内访问速度一般。官网首页或者Download页面往下翻可以看到针对不同系统的下载入口。我们选Windows的版本通常是打包好的zip压缩包也可能是一个exe安装程序具体看当年发布的形式。下载时注意看版本号比如SUMO 1.18.0、1.19.0这样越新的版本功能越全但某些配套工具链比如外部的截图脚本、旧版Python库可能还没跟上如果你是要做更复杂的二次开发建议不要一味追求最新版选上一个稳定版本更省心。下载时有几个文件容易看花眼sumo-win64-xxx.zip这就是我们需要的Windows 64位版本约100多MB解压即用。sumo-src-xxx.zip源码包只有你要在Linux上自己编译或者想读源码才需要Windows用户不要碰。sumo-doc-xxx.zip离线文档新手其实不需要反正线上文档随时能查。有一个容易混淆的情况官网有时会把最新开发版的下载链接也放在页面上标注为nightly或development version。如果你是为了稳定学习不要选这种选普通release版本即可。开发版可能包含新功能但也可能带新bug教程场景求稳不求新。还有个很实际的问题用浏览器直接下载时个别下载工具会把这个zip包分成多段线程下载结果解压时报“文件损坏”。如果遇到解压错误最简单的办法是换个浏览器重新下载一次或者用下载工具的“单线程模式”重试一般都能解决。下载完成后建议右键查看一下文件属性里的“解除锁定”选项尤其从网上下载的zip包Windows会有一层Zone.Identifier标记偶尔会影响解压后的文件执行权限。3.2 从双击到完成安装过程详解拿到zip包之后解压到什么地方是一个值得认真考虑的问题。新手最容易犯的错误是直接把zip包里的文件夹解压到“下载”目录然后用的时候又移动导致环境变量配好了却失效。我的建议是在某个盘符下新建一个专门的目录比如D:\Software\或者C:\Tools\路径里不要有中文、空格和特殊符号。把zip包解压到这个目录下得到类似D:\Software\sumo-1.18.0的文件夹。后续所有关于SUMO的路径配置都指向这个文件夹不要再随意移动它。强烈不建议把SUMO装到C:\Program Files (x86)这类带空格的路径下。虽然理论上Windows能处理路径中的空格但在命令行工具、批处理脚本、Python调用场景中路径带空格意味着所有引用的地方都要加引号任何一个环节漏了就会报错“找不到文件”。为了避免这种无谓的烦恼安装路径纯净一点是第一步。如果是exe安装包双击后按向导点Next即可安装路径同样选择没有中文和空格的目录。安装过程中如果弹出防火墙提示这是SUMO在某些功能下创建本地网络连接比如TraCI远程控制仿真可以勾选“允许访问”不影响正常使用。这个环节还有一个细节不要为了让“看起来干净”就把SUMO的安装目录改名比如把sumo-1.18.0改成sumo然后记不清版本。保持目录名和原压缩包一致以后查日志、看文档时能快速对应版本号。如果你需要同时测试多个SUMO版本直接在D:\Software\下并列解压多个版本文件夹需要哪个就把环境变量改成哪个非常方便。3.3 环境变量配置安装最后一步才是真正的关键解压完成不等于安装结束。很多新手卡在这一步明明SUMO文件夹就在那里双击bin目录下的sumo-gui.exe也能打开图形界面但一进命令行敲sumo --version就提示“不是内部或外部命令”原因就是环境变量没有配置。环境变量是什么你可以把它理解成一个“系统级地址簿”。你在命令行敲入一个命令系统会依次在这个地址簿里列出的所有目录中寻找对应的可执行文件。如果SUMO的bin目录没被登记进这个地址簿系统自然找不到sumo命令。配置步骤如下右键“此电脑”或“我的电脑”选择“属性”。点击左侧“高级系统设置”在弹出窗口中点击右下角“环境变量”。在“系统变量”区域点击“新建”变量名填SUMO_HOME变量值填SUMO的根目录路径比如D:\Software\sumo-1.18.0。在“系统变量”中找到Path这一项选中后点击“编辑”在末尾追加两行路径一个是%SUMO_HOME%\bin另一个是%SUMO_HOME%\tools。把tools目录也加进Path是我特别想强调的一点。SUMO的bin目录里是可执行的exe程序比如sumo.exe、sumo-gui.exe、netedit.exe、netconvert.exe而tools目录里放着大量Python脚本工具比如随机路线生成器randomTrips.py、路网转换工具osmWebWizard.py等。如果你不在Path里加上tools目录想在命令行直接用python randomTrips.py的时候就会提示找不到模块或找不到文件又得去手动cd到tools目录下平白绕路。配置完成后一定要点击“确定”关闭所有窗口不是点右上角叉号。Windows的环境变量修改需要完整的关系链传递如果你还有打开的CMD窗口必须先关掉再重新打开否则新配置不会生效。这个“重启终端”的细节几乎每个新手都会踩一次。最后验证一下配置是否成功打开一个新的CMD窗口输入sumo --version如果看到类似“SUMO Version 1.18.0”的输出就说明环境变量配置成功。如果提示找不到命令排查顺序是先确认是否开的新窗口再确认路径是否写错最后去bin目录下确认sumo.exe是否真的存在。4. 安装完成后怎么验证从命令行到图形界面4.1 那三板斧不只是看版本号配置好环境变量后打开CMD依次输入下面三个命令这是我认为最实用的安装验证流程sumo --version netconvert --version python -c import traci; print(traci ok)第一个命令验证核心仿真器是否可用第二个命令验证路网转换工具是否正确安装。netconvert是SUMO生态里非常重要的一个工具它的职责是把OpenStreetMap导出的地图数据、或者DWG/DXF等格式的道路数据转换成SUMO可以识别的路网文件。如果netconvert有问题后面的所有路网相关操作都会卡住。第三个命令用Python导入traci包确认Python接口能正常找到。这行命令如果在没有安装SUMO Python包的情况下运行大概率会报ModuleNotFoundError。这里涉及一个安装细节SUMO官方发布包的tools目录下包含了traci等Python包的源码但你需要让Python知道去哪里找。最简单的办法是把%SUMO_HOME%\tools这个环境变量配好——如果你在3.3节已经把tools目录加进Path那Python导入traci时会按Path顺序找到它吗这里有个坑Python的sys.path并不会自动包含Path环境变量里的全部目录它只关注那些被注册到site-packages或者PYTHONPATH的路径。所以在已经配置好SUMO_HOME和Path的情况下也可能出现traci导入失败。这时有两个解决方案方案一推荐把%SUMO_HOME%\tools设为PYTHONPATH环境变量。具体操作还是在环境变量设置窗口里新建一个变量名PYTHONPATH变量值填%SUMO_HOME%\tools这样Python就会自动把SUMO的tools目录加入模块搜索路径。方案二使用pip安装官方发布的sumo包。在命令行执行pip install sumo这个包会把traci、sumolib等模块安装到Python的site-packages里。不过要注意pip install sumo安装的只是Python接口不包含SUMO的核心编译程序所以之前解压的SUMO本体还是保留着。两条路不冲突但建议优先用方案一因为它与SUMO版本严格同步不会出现接口包版本和本体不一致的怪问题。4.2 用自带示例跑通第一个仿真版本号和模块导入都正常后下一步是真正跑一个仿真看看图形界面是否正常。这一步看起来很基础但它是整个学习流程中最能建立信心的环节——你亲眼看到车辆在路网中跑起来接下来的一切功能学习都有了具象的基础。SUMO安装目录下自带了一些示例数据比如docs/examples/tutorials/helloworld或者使用osmWebWizard工具在线获取地图。最省事的验证方式是先跑一下安装包自带的demo仿真。找一个终端窗口注意使用普通的CMD即可不需要管理员权限执行sumo-gui这行命令会直接打开SUMO的图形界面界面比较朴素上方是菜单栏和工具栏中间是空旷的仿真画布。如果到这里正常说明GUI能启动。接下来点击菜单栏的File - Open Simulation在文件选择对话框中找到SUMO安装目录下的docs/examples/tutorials/helloworld文件夹打开其中的hello.sumocfg文件然后点击工具栏上的运行按钮绿色三角画布上就会出现一条简单道路和若干辆车在跑动左下角的仿真时间也在跳动。我建议你在窗口里试一下按住鼠标左键拖动视角、滚动滚轮缩放视角。SUMO的默认视角操作逻辑是平移和缩放和很多GIS软件类似。看到车辆移动的瞬间你的安装过程就正式宣告成功。如果双击sumo-gui.exe能打开但命令行敲sumo-gui没反应那还是Path配置不完整回到3.3节检查。如果GUI能开但加载示例文件后画面空白可能是示例路径带空格导致读取失败尝试把示例文件复制到一个无空格的路径下再打开。5. 必装辅助工具与“好用到哭”的配置5.1 Python库安装三个依赖一次装齐基础环境跑通后我建议立刻把Python的依赖库补全这是后续所有自动化操作的前提。在CMD中执行pip install matplotlib pip install pandas pip install xmltodictmatplotlib用来画仿真输出曲线流量-密度图、排队长度随时间变化图等pandas用来处理SUMO输出的大量CSV或XML数据xmltodict则能把SUMO的路网文件和配置文件解析成Python字典写脚本时处理起来比用xml.dom.minidom舒服得多。安装时如果因为网络原因下载慢可以临时加上清华镜像源pip install pandas -i https://pypi.tuna.tsinghua.edu.cn/simple这些依赖库本身和SUMO没有直接绑定关系但它们在后续教程中会被频繁使用。现在都装好后面写脚本时就不用频繁回头补环境。还有一个小工具强烈推荐如果你的Windows 10没有自带“记事本”之外像样的文本编辑器请装一个Visual Studio Code或者Notepad。SUMO的配置文件.sumocfg、.net.xml、.rou.xml本质上都是XML纯文本文件你会经常需要打开它们查看或手工修改。VS Code的XML格式化插件和语法高亮能极大减少漏写标签导致的加载失败。5.2 Netedit可视化编辑路网的入口SUMO提供了一款可视化路网编辑器Netedit它和sumo-gui一样位于bin目录下双击netedit.exe或者命令行输入netedit即可启动。Netedit的功能是创建和编辑路网文件画道路、建交叉口、设置信号灯、定义车道属性等。如果你是第一次接触建议先不要贸然用Netedit画路网而是在学习初期多依赖命令行的netconvert工具和Python脚本自动生成路网。原因是Netedit手动画路网看起来直观但精细调整每条车道的宽度、限速、连接关系时工作量巨大且容易出错。而通过脚本从OpenStreetMap导入路网或者用randomTrips.py随机生成出行需求是更高效且可复现的方式。Netedit真正的高频使用场景是微调比如你在脚本生成的路网上想要把一个交叉口的右转车道变成直右合用车道这时候在Netedit里改比写XML快得多。第5篇左右的教程会专门讲Netedit的实用操作现在是安装阶段只需要确认它能正常打开、界面不报错即可。6. 常见安装问题与排查实录6.1 五个高频问题排查速查表我在给学生们装SUMO的过程中几乎每次都能遇到类似问题。整理成表格放在下面方便你遇到问题时快速定位现象可能原因解决方法CMD敲sumo提示“不是内部或外部命令”Path环境变量未配置或未生效重新配置Path并关闭所有CMD窗口后重新打开sumo --version能运行但python导入traci失败PYTHONPATH未配置或未配置SUMO_HOME新建PYTHONPATH变量指向tools目录sumo-gui打开后地图区域全黑/空白显卡驱动问题或OpenGL兼容问题更新显卡驱动尝试用Windows的“兼容性疑难解答”解压zip包时报文件损坏或CRC错误下载不完整或下载工具多线程问题删掉重下用浏览器单线程下载验证文件大小打开示例文件后点运行无反应示例路径含中文/空格复制示例文件夹到无中文无空格路径下再打开netconvert报缺少MSVCP140.dll缺少Visual C运行库到微软官网下载安装Visual C Redistributable 2015-2022 x64最后这个MSVCP140.dll问题特别常见不仅SUMO会遇到很多Windows下的C程序都依赖这个运行库。只要装了Visual C Redistributable基本都能解决。6.2 几个容易被忽略但影响很大的细节第一安装路径决定“一个变量解决所有引用”。我们配置了SUMO_HOME环境变量后所有地方都可以通过%SUMO_HOME%来引用SUMO的根目录比如在批处理脚本里写%SUMO_HOME%\tools\xml\csv2xml.py。但如果路径里包含空格或中文某些老旧脚本会出现找不到文件的bug排查起来非常折磨人。所以再三强调安装路径务必干净。第二Windows 10自带的杀毒软件有时“多管闲事”。在解压或运行SUMO时Windows Defender可能会对某些Python脚本或二进制文件进行实时扫描导致启动变慢极少数情况会误删文件。如果你发现某些文件莫名其妙消失去“病毒和威胁防护-保护历史记录”里查看一下记录。如果确认是误删可以添加排除项把SUMO所在目录加入排除列表。第三不要用PowerShell代替CMD跑SUMO指令。PowerShell和CMD的命令兼容性大体没问功能但部分环境变量刷新和路径解析的细节存在差异尤其是调用批处理或Python脚本时偶尔会遇到莫名其妙的格式错误。官方文档里的操作示例都是以CMD为基准的学习阶段老老实实用CMD能少踩很多坑。第四注意SUMO的“每日自动构建版”和“发行版”的区别。官网首页有时会放着nightly build的下载入口版本号可能比正式版新但API可能变动。如果你跟着教程学习时遇到“教程里说的菜单找不到”或者“参数名不认”的问题很可能是因为装了开发版或发行版之间的差异。切换到正式发行版问题多半就消失了。7. 为下一步做好准备目录结构速览安装完成后花五分钟了解一下SUMO的目录结构会对后面的学习非常有帮助。以解压后的sumo-1.18.0目录为例bin/存放所有可执行文件。sumo.exe是命令行仿真器不带图形界面sumo-gui.exe是图形界面版netconvert.exe负责路网转换netedit.exe是路网编辑器。后面95%的操作离不开这里。tools/存放大量Python辅助脚本。比如randomTrips.py用于在路网中随机生成车辆出行osmWebWizard.py可以从OpenStreetMap直接下载地图并生成仿真场景traceExporter.py等工具用于轨迹数据转换。docs/官方文档和教程示例。注意实际路径多为docs/userdoc里面有很多HTML文件可以离线浏览初学者多翻翻官方教程Tutorials非常有帮助。data/默认的车型参数、排放模型、公交停靠数据等。当你需要调整车辆的加速度、最大速度、排放因子时会到这里找参考。打开CMD输入下面这行命令测试一下Python脚本工具是否能正常调用python %SUMO_HOME%\tools\randomTrips.py --help如果能看到这个脚本的参数说明比如--help输出的选项列表说明tools目录下的脚本可以正常调用环境准备全部完成。这个randomTrips.py是一个非常常用的工具它的作用是给定一个路网文件自动生成随机的车辆起点、终点和出发时间生成车辆路径文件.rou.xml。后续做仿真实验时它几乎是必用的。做完这些你的Windows 10系统上已经有一套完整的、可扩展的SUMO开发环境了。下一篇教程我打算讲怎么从OpenStreetMap导出真实地图用netconvert转换成SUMO路网再用randomTrips.py生成车辆流配合sumo-gui跑通一个真实城市片段的仿真场景——这是从“能运行”到“做研究”的关键一步。最后说一个我自己的体会安装配置这种看似枯燥的环节恰恰是最值得认真对待的部分。很多人在环境上反复踩坑并不是因为SUMO难装而是跳过了对环境变量的理解、对路径规范的认识、对依赖关系的梳理。这些东西搞清楚了后面建路网、调参数、写Python脚本时你会明显感觉顺手很多。教程里提到的路径规范和版本选择建议一开始就养成好习惯省得以后跑大了再来返工。