做交通仿真的人十有八九绕不开SUMO。这套由德国宇航中心DLR开源的微观交通仿真工具从2001年诞生到现在已经成了学术界和工业界事实上的标准之一。我在这个领域摸爬滚打了几年从最早的SUMO 0.x版本用到现在的1.x系列中间踩过的坑、翻过的车不算少。这篇就结合我自己实际折腾的经验把SUMO的概述和安装配置这部分一次性讲透给正准备入坑的同学一条尽量平坦的路。很多新手一上来就懵SUMO到底是什么怎么装上去了打开一看一堆xml文件环境变量到底要不要配配置到一半报错怎么办这些问题我当年都遇到过。写这篇文章的目的就是把这些零散的困惑集中解决掉从软件定位、安装前的准备、不同平台的实操步骤到常见坑点的排查最后再带出一个能跑通的完整小demo让你从零开始半天内真正把SUMO用起来。1. 先把SUMO看明白它不是一个画个圈就仿真的玩具1.1 微观交通仿真到底在仿什么要理解SUMO先要搞清楚微观交通仿真这个词。宏观仿真比如TransCAD里做四阶段模型研究的是路网级别的交通流看的是OD矩阵、路段的交通量中观仿真介于两者之间把车队当作整体来刻画而微观仿真则是把每一辆车、每一个行人、每一条车道都纳入计算。SUMO属于微观仿真中非常典型的一类——它逐秒跟踪每一辆车的位置、速度、加速度车辆跟驰、换道、超车、信号灯响应都通过模型显式计算出来。SUMO全称Simulation of Urban MObility城市交通流动性仿真它的核心设计目标有三块一是大规模能支撑城市级乃至区域级的路网二是高精度时间步长在毫秒级到秒级均可配置三是可扩展所有输入输出都基于XML几乎每一个层面都开放了API接口特别适合做二次开发。这就引出一个很多初学者没意识到的问题SUMO本身就是一个完整的软件体系而不是单一的可执行程序。装上之后你会看到sumo命令行仿真核心、sumo-gui可视化仿真器、netedit路网编辑器、duarouter路径分配、marouter宏观路径分配、polyconvert多边形转换、netconvert路网格式转换等一系列工具。它们彼此之间有明确的分工共同组成一条从路网搭建到仿真分析的生产链。1.2 我实际用下来SUMO最能打和最拉胯的地方先说最打动我的地方。第一是开放性SUMO从模型算法到文件格式全部公开没有任何黑箱论文里需要改跟驰参数直接改XML需要自定义交通控制逻辑TraCI接口可以让你在Python里动态控制每一辆车。第二是跨平台Windows、Linux、macOS官方都提供支持这在交通仿真软件里非常少见商业软件如Vissim基本是Windows独占Aimsun虽然在多平台有版本但价格劝退。第三是生态链。SUMO可以和OMNeT、Veins做车联网V2X联合仿真可以和TensorFlow等深度学习框架联动做交通预测还能通过TraCI接入MATLAB。我在做一个信号控制优化项目时直接把SUMO封装成Python环境里的一个仿真引擎和强化学习agent实时交互体验非常顺滑。不足的地方也很明显。首先是图形化编辑能力偏弱netedit虽然这些年进步很大但比Vissim那种所见即所得的建模体验还是有差距复杂的立体交叉、精细的信号相位配置都要花时间适应。其次是文档的学习曲线陡峭官方文档信息密度极高但缺乏面向新手的中文资料很多细节要靠翻论坛、翻源码才能确认。再有一个是老生常谈的性能问题一旦路网规模上来、车辆数上万仿真速度会明显下降虽然支持多线程但调度效率还是不如一些商业软件优化得那么极致。1.3 哪些人适合用SUMO哪些人可能不适合从我的观察来看三类人群最适合SUMO。第一类是高校和科研机构的研究人员因为开源免费、可复现性强学术圈几乎把它当作共享基准工具第二类是车联网和自动驾驶领域的工程师需要做大量的交通场景仿真测试SUMO的TraCI和场景导入功能在这块几乎是刚需第三类是城市规划和管理部门的技术支持人员用SUMO做局部路网的改造评估、信号优化实验成本可控。反过来如果你只想要一个能出漂亮动画给领导汇报的仿真工具或者你几乎没有编程经验、也完全不想接触XML和脚本那SUMO会让你比较难受。它的定位是给懂交通的人用的实验室工具而不是面向演示的商用产品。建议先评估自己的需求再决定是否投入时间。2. 安装前的关键决策选对方式后面少走一半弯路2.1 三种安装路线怎么选SUMO的安装不像普通软件那样只有双击下一步一个选项常见的有三种路线官方预编译包、包管理器安装、源码编译。很多人第一次就卡在选哪条路上这里把我的实际建议讲清楚。官方预编译包Windows和macOS是最推荐新手的路线。SUMO官网直接提供.exe安装包Windows和.dmg镜像macOS安装过程是图形化的自动处理依赖库和基础环境配置。你不需要有编译经验装完基本就能用。缺点是版本更新有延迟新版本发布后要等一段时间才有预编译包。包管理器安装Linux和macOS是懒人但可靠的选择。Ubuntu/Debian系直接用apt install sumoFedora用dnf install sumomacOS可以用Homebrew的brew install sumo。这条路的好处是依赖自动解决、和系统集成度高缺点是版本往往偏旧。源码编译适合需要修改源码、或者需要追新版本的进阶用户。SUMO依赖较多包括gdal、proj、fox、xerces-c等第一次编译容易在依赖环节劝退。我不建议新手直接从源码开始除非你有明确的需求或者你已经建立了对整体工具链的把握。2.2 环境依赖其实比你想象中简单很多刚接触SUMO的同学会被网上教程里需要安装Python、需要配置Java、需要装CMake这些信息吓到。这里我帮你理一理哪些是真需求哪些是不必要的。运行SUMO本体sumo和sumo-gui本身不依赖Python它是个C程序。但SUMO的工具链里大量脚本是用Python写的比如tools/目录下各种辅助脚本、traci库、部分route生成工具所以推荐安装Python 3.7以上版本并且建议安装pip后面会用到。Java不是必需的除非你要用TraaSTraCI的Java API或者某些依赖Java的可视化工具。CMake只在源码编译时需要用预编译包或包管理器安装则完全不需要。还有一个经常被忽略的依赖是C运行库。Windows上如果安装后运行报缺MSVCP140.dll之类的错误说明缺Visual C Redistributable装上最新版就行。另外SUMO的图形界面依赖OpenGL如果你的机器显卡驱动太老可能出现窗口能开但渲染异常的情况。2.3 环境变量SUMO_HOME不理解透后面必踩坑配置环境变量这一步是新手翻车最集中的地方之一。SUMO的许多工具需要根据SUMO_HOME变量找到资源文件、数据文件、工具脚本。如果这个变量没有配好常见的表现包括命令行运行python脚本时找不到sumo路径、netedit打开后加载默认配置失败、sumo-gui报找不到配置文件等。在Windows上安装包一般会自动设置SUMO_HOME但很多情况下只是设置了当前用户的变量而没有同步到系统变量或者安装路径是C:\Program Files (x86)\Eclipse SUMO\sumo-1.20.0而你手动配置时少了一层目录。在Linux上如果你是用源码编译而没有执行make install那么SUMO_HOME需要指向源码根目录。我的建议是无论什么平台安装完成后都要手动验证一下SUMO_HOME是否指向正确目录然后在终端里执行sumo --version能正确打印版本号再继续后面的学习。这也是接下来实操环节的第一步。3. 实操环节安装配置全流程逐项拆解3.1 Windows平台从下载到跑通demo的完整记录我以Windows 11系统、SUMO 1.20.0版本为例把每一步实际操作记录下来。不同小版本细节可能有差异但总体流程是稳定通用的。第一步去SUMO官网sumo.dlr.de下载页选择Windows标签下的.exe安装包。下载完成后双击运行。这里注意安装路径不要带中文和空格最好直接用默认路径比如C:\Program Files\Eclipse SUMO\sumo-1.20.0。我之前见过有人把SUMO装到D:\软件\交通仿真\sumo结果某些脚本因为路径解析问题找不到文件白折腾半天。第二步安装过程中选择组件时默认是全选的。建议你保持全选因为里面包括sumo-gui、netedit、netconvert、duarouter这些基础工具还包括traci相关的Python库和演示数据。有人为了省硬盘空间把extra tools去掉后面用的时候抱怨怎么没有某个脚本其实就在tools目录里。第三步验证SUMO_HOME是否配置成功。打开系统属性-环境变量在用户变量里找有没有SUMO_HOME。如果没有或路径不对手动新建变量值填SUMO的安装主目录。注意这个主目录的特征是它下面直接有bin、tools、data这三级目录。我自己有一次配成了bin目录的路径结果SUMO_HOME指向了...\sumo-1.20.0\bin导致一堆工具找不到资源文件排查了好久才反应过来。第四步把%SUMO_HOME%\bin追加到PATH环境变量中。这样你在任意目录打开终端都能直接用sumo、netedit等命令。如果不做这一步你就只能每次先cd到bin目录再执行非常繁琐。第五步验证安装。新开一个终端重要改完环境变量后已经打开的命令行窗口不会自动生效必须新开执行sumo --version如果输出类似SUMO Version 1.20.0的信息说明核心程序已经没问题。接下来执行sumo-gui能弹出图形界面窗口就说明图形模块正常。如果sumo-gui打不开多半是OpenGL或显卡驱动的问题先更新显卡驱动再检查是否缺少系统组件。第六步跑一个官方示例来验证全流程。进入安装目录下的docs/examples/sumo目录也可以直接运行%SUMO_HOME%\docs\examples\sumo\下的文件找一个简单的demodemo比如cross或hello文件夹切换到该目录后执行sumo -c run.sumocfg如果能正常跑完并输出车辆轨迹文件安装和配置就完全没问题了。3.2 Linux平台包管理器安装与源码编译的分界线Linux上安装SUMO大部分情况我建议直接用包管理器。以Ubuntu 22.04 LTS为例sudo apt update sudo apt install sumo sumo-tools sumo-doc这里注意Ubuntu仓库里的sumo包只包含核心程序sumo-tools才是包含大量Python脚本的工具集sumo-doc是文档。我见过不少人只装了sumo然后找不到netedit、找不到tools下的脚本其实就是把sumo-tools漏掉了。安装完成后SUMO_HOME默认是/usr/share/sumo你可以通过echo $SUMO_HOME来确认。如果变量没设置在~/.bashrc或~/.zshrc中加入export SUMO_HOME/usr/share/sumo export PATH$PATH:$SUMO_HOME/bin然后source ~/.bashrc生效。如果你需要使用最新的开发版功能或者你有定制C代码的需求那就得走源码编译路线。这里只说关键点首先是安装依赖sudo apt install build-essential cmake libxerces-c-dev libfox-1.6-dev libgdal-dev libproj-dev libgl2ps-dev libx11-dev libxmu-dev libxi-dev libglu1-mesa-dev libxerces-c-dev然后从GitHub克隆源码git clone --recursive https://github.com/eclipse-sumo/sumo.git cd sumo mkdir build cd build cmake .. make -j$(nproc)编译过程可能持续20到60分钟取决于机器性能。编译完成后可执行文件在bin目录中。需要手动配置export SUMO_HOME/path/to/sumo export PATH$PATH:$SUMO_HOME/bin源码编译的坑主要在依赖版本不兼容上尤其是gdal的版本、proj的版本升级后API有变化编译时会报一堆头文件错误。遇到这种情况网上搜报错信息基本都能在SUMO官方GitHub的issue区找到答案这里不展开。3.3 macOS平台的特殊细节macOS上安装SUMO我试过两种方式Homebrew和官方dmg包。Homebrew方式最简单brew install sumo但要注意Homebrew安装的SUMO版本可能落后于官方最新版。如果你需要用最新特性还是去官网下dmg包。dmg包安装后把SUMO_HOME设置到/Applications/sumo.app/Contents/Resources/sumo不同版本路径有差异再用export PATH$PATH:$SUMO_HOME/bin配置PATH。macOS版还有一个特点由于系统对未签名应用的限制第一次打开sumo-gui时可能需要右键-打开才会弹出允许运行的提示。这不是软件问题别慌。3.4 安装完成后的第一组验证清单我整理了一个验证清单建议每一条都过一遍检查项检验命令预期结果SUMO_HOMEecho $SUMO_HOME路径指向SUMO主目录核心仿真器sumo --version打印版本号图形仿真器sumo-gui弹出GUI窗口路网编辑器netedit --version打印版本号Python工具链python -c import sumolib无报错TraCI接口python -c import traci无报错第5、6条特别容易被人忽略。sumolib和traci是SUMO做二次开发的核心库它们通常在SUMO_HOME/tools下。如果你在Python环境里import失败多半是两个原因一是没把SUMO_HOME/tools加入Python模块搜索路径二是在其他Python虚拟环境中而没有安装对应的包。建议把SUMO_HOME/tools通过.pth文件或环境变量加到Python路径里或者直接在需要用的虚拟环境中执行pip install traci sumolib这两者其实已经发布了PyPI包pip安装是更干净的方式。4. 安装配置时最常见的重复问题这里一次性说透4.1 环境变量配置了但不生效的三类原因我在各大技术社区里看到的环境变量不生效问题基本可以归为三类。第一类是修改后没有新开终端。Windows上修改环境变量后当前已打开的命令行窗口不会刷新环境变量必须关掉重开macOS和Linux上修改~/.bashrc后要执行source ~/.bashrc或者新开终端。这个原因产生的报障占比最高。第二类是系统变量和用户变量冲突。Windows上如果你在系统变量里设置了SUMO_HOME指向A版本又在用户变量里设置了SUMO_HOME指向B版本系统会优先使用用户变量。我曾经因为两个版本指向不同导致sumo --version显示的版本和netedit实际版本不一致运行脚本时找不到对应版本的配置文件。第三类是变量值多了空格或斜杠方向错误。Windows的环境变量值结尾多了一个空格或者用了正斜杠C:/Program Files/...有些工具能容错有些则不能。统一用反斜杠、不要加空格是最稳妥的写法。4.2 依赖库缺失导致的启动失败怎么定位Windows上sumo-gui启动时报The code execution cannot proceed because MSVCP140.dll was not found这是缺Visual C运行库。去微软官网下载vc_redist.x64.exe安装即可。如果你用源码编译链接时报cannot find -lxxx说明对应的开发库没有安装。用apt-file search或dnf provides来定位缺失的dev包是最高效的方法。Linux上还常见libgdal.so.XX: cannot open shared object file这类报错说明gdal库版本不匹配。如果是包管理器安装的试试apt install --reinstall sumo让依赖重新解析如果是源码编译的可能需要重新编译并确保LD_LIBRARY_PATH包含编译时使用的库路径。4.3 版本间兼容性问题不容小觑SUMO的配置文件和路网文件格式在不同大版本之间有时是不兼容的。比如1.14版本生成的路网在1.12版本上打开可能报错更早的0.32版本文件直接拿到1.20版本里也可能会丢字段。我个人的习惯是固定一个版本用于整个项目周期。如果确实需要升级要检查netconvert能否正常解析旧路网、duarouter能否读取旧的rou.xml百度搜索配置再检查仿真脚本里的TraCI代码是否调用了被废弃的API。官网的docs/ChangeLog页面会列出每个版本的破坏性变更升级前扫一遍这个列表能省不少事。4.4 一张表记住常见安装配置问题问题现象可能原因解决方案终端提示sumo不是内部或外部命令PATH未配置或未新开终端配置PATH并新开终端import traci报ModuleNotFoundErrorPython路径未包含tracipip install traci或配置PYTHONPATHsumo-gui打开后界面空白/闪退OpenGL/显卡驱动问题更新显卡驱动检查OpenGL支持源码编译报xercesc/... not found缺少xerces-c开发库安装libxerces-c-dev运行脚本报SUMO_HOME is not setSUMO_HOME未配置或指向错误重新配置并验证目录结构配置文件报Could not open network file路网文件路径错误或版本不兼容检查相对路径确认路网版本这些坑我基本都在实际项目中踩过。最想反复强调的依然是每次改完环境配置先新开一个终端再用sumo --version验证一次。这一步做到位至少能消掉一半以上的安装配置问题。5. 安装配置完成后先动手做一个小项目才算真正会用5.1 一段话搞懂SUMO的输入与输出文件体系SUMO仿真有三个最基础的文件类型路网文件.net.xml、需求文件.rou.xml、配置文件.sumocfg。示例中的run.sumocfg就是配置文件它告诉sumo去哪儿找路网和需求文件、仿真从第几秒开始到第几秒结束、输出哪些结果。我现在带你把这三个文件串起来跑通一个最小例子。5.2 用netedit快速画一个十字路口打开netedit方式很简单命令行执行netedit或直接双击启动。进入界面后我建议先选择Network模式默认就是在画布上拉出两条垂直交叉的路地道地形成十字路口。注意SUMO的车道是单向的你需要为每一条现实中的双向路分别画两条方向相反的车道。画完道路后系统会自动生成节点junction。如果你画的交叉口信号灯可以在节点属性里把Type改为traffic_light再设置相位方案。保存时netedit会默认导出.net.xml文件命名随意比如mynet.net.xml。很多新手在这里会纠结要不要画得很精细。我的建议是第一遍先追求能跑复杂交叉口、车道连接器、公交站点这些全都后面再加。能跑通完整流程比一次画一个完美的路网重要得多。5.3 生成交通需求并启动仿真有了路网文件还需要车辆文件。我不会手写xml去定义每条车辆的具体路径而是用随机交通流生成工具flowrouter.py或者直接用duarouter。更简单的方式是用python tools/randomTrips.py生成python $SUMO_HOME/tools/randomTrips.py -n mynet.net.xml -o mytrips.trips.xml -e 1000 --period 2 --random这个脚本会生成1000秒内、每2秒一辆车的随机出行需求。然后写一个配置文件demo.sumocfg内容如下?xml version1.0 encodingUTF-8? configuration input net-file valuemynet.net.xml/ route-files valuemytrips.trips.xml/ /input time begin value0/ end value1000/ /time /configuration最后执行sumo-gui -c demo.sumocfg你会看到界面里车辆沿路网行驶一辆接一辆从生成点驶向目的地。到这里你的SUMO环境已经彻底打通了接下来无论是学TraCI二次开发还是做信号优化实验都有了基础环境。我个人强烈建议你把官方仓库里的docs/examples整个翻一遍每个例子都跑一遍比看十篇教程都有效。5.4 配置完SUMO接下来值得关注的扩展方向安装配置只是SUMO之旅的第一步后面可以深入的方向很多。如果你做交通工程可以深入研究不同跟驰模型如Krauss、IDM的参数标定与对比如果你做自动驾驶仿真研究TraCI的不间断控制、传感器模拟、通信仿真插件如Plexe是核心如果你做信号控制研究libsumo的在线API和强化学习结合是当前热门方向。再往下你还会接触到网络级别的仿真、公交车调度、排放模型HBEFA、PHEMlight等高级模块但这些都要建立在SUMO环境稳定可用的基础上。先把基础打牢后面才飞得起来。写在最后反复折腾过SUMO的安装配置后我最大的体会有两点一是官方文档的installation章节值得先读三遍很多我以为是自己操作失误的问题其实文档里都有说明二是固定一个版本并做好环境隔离不同项目尽量用统一的SUMO版本和Python环境能避免大量版本冲突引起的时间浪费。建议你装好之后把今天文中提到的验证清单存成一份笔记未来换电脑、升级系统时直接照做能舒心不少。 
长河君 · 2026/9/28 23:29:54 · 阅读 1.2k SUMO交通仿真从入门到精通：安装配置全流程实战指南
做交通仿真的人十有八九绕不开SUMO。这套由德国宇航中心DLR开源的微观交通仿真工具从2001年诞生到现在已经成了学术界和工业界事实上的标准之一。我在这个领域摸爬滚打了几年从最早的SUMO 0.x版本用到现在的1.x系列中间踩过的坑、翻过的车不算少。这篇就结合我自己实际折腾的经验把SUMO的概述和安装配置这部分一次性讲透给正准备入坑的同学一条尽量平坦的路。很多新手一上来就懵SUMO到底是什么怎么装上去了打开一看一堆xml文件环境变量到底要不要配配置到一半报错怎么办这些问题我当年都遇到过。写这篇文章的目的就是把这些零散的困惑集中解决掉从软件定位、安装前的准备、不同平台的实操步骤到常见坑点的排查最后再带出一个能跑通的完整小demo让你从零开始半天内真正把SUMO用起来。1. 先把SUMO看明白它不是一个画个圈就仿真的玩具1.1 微观交通仿真到底在仿什么要理解SUMO先要搞清楚微观交通仿真这个词。宏观仿真比如TransCAD里做四阶段模型研究的是路网级别的交通流看的是OD矩阵、路段的交通量中观仿真介于两者之间把车队当作整体来刻画而微观仿真则是把每一辆车、每一个行人、每一条车道都纳入计算。SUMO属于微观仿真中非常典型的一类——它逐秒跟踪每一辆车的位置、速度、加速度车辆跟驰、换道、超车、信号灯响应都通过模型显式计算出来。SUMO全称Simulation of Urban MObility城市交通流动性仿真它的核心设计目标有三块一是大规模能支撑城市级乃至区域级的路网二是高精度时间步长在毫秒级到秒级均可配置三是可扩展所有输入输出都基于XML几乎每一个层面都开放了API接口特别适合做二次开发。这就引出一个很多初学者没意识到的问题SUMO本身就是一个完整的软件体系而不是单一的可执行程序。装上之后你会看到sumo命令行仿真核心、sumo-gui可视化仿真器、netedit路网编辑器、duarouter路径分配、marouter宏观路径分配、polyconvert多边形转换、netconvert路网格式转换等一系列工具。它们彼此之间有明确的分工共同组成一条从路网搭建到仿真分析的生产链。1.2 我实际用下来SUMO最能打和最拉胯的地方先说最打动我的地方。第一是开放性SUMO从模型算法到文件格式全部公开没有任何黑箱论文里需要改跟驰参数直接改XML需要自定义交通控制逻辑TraCI接口可以让你在Python里动态控制每一辆车。第二是跨平台Windows、Linux、macOS官方都提供支持这在交通仿真软件里非常少见商业软件如Vissim基本是Windows独占Aimsun虽然在多平台有版本但价格劝退。第三是生态链。SUMO可以和OMNeT、Veins做车联网V2X联合仿真可以和TensorFlow等深度学习框架联动做交通预测还能通过TraCI接入MATLAB。我在做一个信号控制优化项目时直接把SUMO封装成Python环境里的一个仿真引擎和强化学习agent实时交互体验非常顺滑。不足的地方也很明显。首先是图形化编辑能力偏弱netedit虽然这些年进步很大但比Vissim那种所见即所得的建模体验还是有差距复杂的立体交叉、精细的信号相位配置都要花时间适应。其次是文档的学习曲线陡峭官方文档信息密度极高但缺乏面向新手的中文资料很多细节要靠翻论坛、翻源码才能确认。再有一个是老生常谈的性能问题一旦路网规模上来、车辆数上万仿真速度会明显下降虽然支持多线程但调度效率还是不如一些商业软件优化得那么极致。1.3 哪些人适合用SUMO哪些人可能不适合从我的观察来看三类人群最适合SUMO。第一类是高校和科研机构的研究人员因为开源免费、可复现性强学术圈几乎把它当作共享基准工具第二类是车联网和自动驾驶领域的工程师需要做大量的交通场景仿真测试SUMO的TraCI和场景导入功能在这块几乎是刚需第三类是城市规划和管理部门的技术支持人员用SUMO做局部路网的改造评估、信号优化实验成本可控。反过来如果你只想要一个能出漂亮动画给领导汇报的仿真工具或者你几乎没有编程经验、也完全不想接触XML和脚本那SUMO会让你比较难受。它的定位是给懂交通的人用的实验室工具而不是面向演示的商用产品。建议先评估自己的需求再决定是否投入时间。2. 安装前的关键决策选对方式后面少走一半弯路2.1 三种安装路线怎么选SUMO的安装不像普通软件那样只有双击下一步一个选项常见的有三种路线官方预编译包、包管理器安装、源码编译。很多人第一次就卡在选哪条路上这里把我的实际建议讲清楚。官方预编译包Windows和macOS是最推荐新手的路线。SUMO官网直接提供.exe安装包Windows和.dmg镜像macOS安装过程是图形化的自动处理依赖库和基础环境配置。你不需要有编译经验装完基本就能用。缺点是版本更新有延迟新版本发布后要等一段时间才有预编译包。包管理器安装Linux和macOS是懒人但可靠的选择。Ubuntu/Debian系直接用apt install sumoFedora用dnf install sumomacOS可以用Homebrew的brew install sumo。这条路的好处是依赖自动解决、和系统集成度高缺点是版本往往偏旧。源码编译适合需要修改源码、或者需要追新版本的进阶用户。SUMO依赖较多包括gdal、proj、fox、xerces-c等第一次编译容易在依赖环节劝退。我不建议新手直接从源码开始除非你有明确的需求或者你已经建立了对整体工具链的把握。2.2 环境依赖其实比你想象中简单很多刚接触SUMO的同学会被网上教程里需要安装Python、需要配置Java、需要装CMake这些信息吓到。这里我帮你理一理哪些是真需求哪些是不必要的。运行SUMO本体sumo和sumo-gui本身不依赖Python它是个C程序。但SUMO的工具链里大量脚本是用Python写的比如tools/目录下各种辅助脚本、traci库、部分route生成工具所以推荐安装Python 3.7以上版本并且建议安装pip后面会用到。Java不是必需的除非你要用TraaSTraCI的Java API或者某些依赖Java的可视化工具。CMake只在源码编译时需要用预编译包或包管理器安装则完全不需要。还有一个经常被忽略的依赖是C运行库。Windows上如果安装后运行报缺MSVCP140.dll之类的错误说明缺Visual C Redistributable装上最新版就行。另外SUMO的图形界面依赖OpenGL如果你的机器显卡驱动太老可能出现窗口能开但渲染异常的情况。2.3 环境变量SUMO_HOME不理解透后面必踩坑配置环境变量这一步是新手翻车最集中的地方之一。SUMO的许多工具需要根据SUMO_HOME变量找到资源文件、数据文件、工具脚本。如果这个变量没有配好常见的表现包括命令行运行python脚本时找不到sumo路径、netedit打开后加载默认配置失败、sumo-gui报找不到配置文件等。在Windows上安装包一般会自动设置SUMO_HOME但很多情况下只是设置了当前用户的变量而没有同步到系统变量或者安装路径是C:\Program Files (x86)\Eclipse SUMO\sumo-1.20.0而你手动配置时少了一层目录。在Linux上如果你是用源码编译而没有执行make install那么SUMO_HOME需要指向源码根目录。我的建议是无论什么平台安装完成后都要手动验证一下SUMO_HOME是否指向正确目录然后在终端里执行sumo --version能正确打印版本号再继续后面的学习。这也是接下来实操环节的第一步。3. 实操环节安装配置全流程逐项拆解3.1 Windows平台从下载到跑通demo的完整记录我以Windows 11系统、SUMO 1.20.0版本为例把每一步实际操作记录下来。不同小版本细节可能有差异但总体流程是稳定通用的。第一步去SUMO官网sumo.dlr.de下载页选择Windows标签下的.exe安装包。下载完成后双击运行。这里注意安装路径不要带中文和空格最好直接用默认路径比如C:\Program Files\Eclipse SUMO\sumo-1.20.0。我之前见过有人把SUMO装到D:\软件\交通仿真\sumo结果某些脚本因为路径解析问题找不到文件白折腾半天。第二步安装过程中选择组件时默认是全选的。建议你保持全选因为里面包括sumo-gui、netedit、netconvert、duarouter这些基础工具还包括traci相关的Python库和演示数据。有人为了省硬盘空间把extra tools去掉后面用的时候抱怨怎么没有某个脚本其实就在tools目录里。第三步验证SUMO_HOME是否配置成功。打开系统属性-环境变量在用户变量里找有没有SUMO_HOME。如果没有或路径不对手动新建变量值填SUMO的安装主目录。注意这个主目录的特征是它下面直接有bin、tools、data这三级目录。我自己有一次配成了bin目录的路径结果SUMO_HOME指向了...\sumo-1.20.0\bin导致一堆工具找不到资源文件排查了好久才反应过来。第四步把%SUMO_HOME%\bin追加到PATH环境变量中。这样你在任意目录打开终端都能直接用sumo、netedit等命令。如果不做这一步你就只能每次先cd到bin目录再执行非常繁琐。第五步验证安装。新开一个终端重要改完环境变量后已经打开的命令行窗口不会自动生效必须新开执行sumo --version如果输出类似SUMO Version 1.20.0的信息说明核心程序已经没问题。接下来执行sumo-gui能弹出图形界面窗口就说明图形模块正常。如果sumo-gui打不开多半是OpenGL或显卡驱动的问题先更新显卡驱动再检查是否缺少系统组件。第六步跑一个官方示例来验证全流程。进入安装目录下的docs/examples/sumo目录也可以直接运行%SUMO_HOME%\docs\examples\sumo\下的文件找一个简单的demodemo比如cross或hello文件夹切换到该目录后执行sumo -c run.sumocfg如果能正常跑完并输出车辆轨迹文件安装和配置就完全没问题了。3.2 Linux平台包管理器安装与源码编译的分界线Linux上安装SUMO大部分情况我建议直接用包管理器。以Ubuntu 22.04 LTS为例sudo apt update sudo apt install sumo sumo-tools sumo-doc这里注意Ubuntu仓库里的sumo包只包含核心程序sumo-tools才是包含大量Python脚本的工具集sumo-doc是文档。我见过不少人只装了sumo然后找不到netedit、找不到tools下的脚本其实就是把sumo-tools漏掉了。安装完成后SUMO_HOME默认是/usr/share/sumo你可以通过echo $SUMO_HOME来确认。如果变量没设置在~/.bashrc或~/.zshrc中加入export SUMO_HOME/usr/share/sumo export PATH$PATH:$SUMO_HOME/bin然后source ~/.bashrc生效。如果你需要使用最新的开发版功能或者你有定制C代码的需求那就得走源码编译路线。这里只说关键点首先是安装依赖sudo apt install build-essential cmake libxerces-c-dev libfox-1.6-dev libgdal-dev libproj-dev libgl2ps-dev libx11-dev libxmu-dev libxi-dev libglu1-mesa-dev libxerces-c-dev然后从GitHub克隆源码git clone --recursive https://github.com/eclipse-sumo/sumo.git cd sumo mkdir build cd build cmake .. make -j$(nproc)编译过程可能持续20到60分钟取决于机器性能。编译完成后可执行文件在bin目录中。需要手动配置export SUMO_HOME/path/to/sumo export PATH$PATH:$SUMO_HOME/bin源码编译的坑主要在依赖版本不兼容上尤其是gdal的版本、proj的版本升级后API有变化编译时会报一堆头文件错误。遇到这种情况网上搜报错信息基本都能在SUMO官方GitHub的issue区找到答案这里不展开。3.3 macOS平台的特殊细节macOS上安装SUMO我试过两种方式Homebrew和官方dmg包。Homebrew方式最简单brew install sumo但要注意Homebrew安装的SUMO版本可能落后于官方最新版。如果你需要用最新特性还是去官网下dmg包。dmg包安装后把SUMO_HOME设置到/Applications/sumo.app/Contents/Resources/sumo不同版本路径有差异再用export PATH$PATH:$SUMO_HOME/bin配置PATH。macOS版还有一个特点由于系统对未签名应用的限制第一次打开sumo-gui时可能需要右键-打开才会弹出允许运行的提示。这不是软件问题别慌。3.4 安装完成后的第一组验证清单我整理了一个验证清单建议每一条都过一遍检查项检验命令预期结果SUMO_HOMEecho $SUMO_HOME路径指向SUMO主目录核心仿真器sumo --version打印版本号图形仿真器sumo-gui弹出GUI窗口路网编辑器netedit --version打印版本号Python工具链python -c import sumolib无报错TraCI接口python -c import traci无报错第5、6条特别容易被人忽略。sumolib和traci是SUMO做二次开发的核心库它们通常在SUMO_HOME/tools下。如果你在Python环境里import失败多半是两个原因一是没把SUMO_HOME/tools加入Python模块搜索路径二是在其他Python虚拟环境中而没有安装对应的包。建议把SUMO_HOME/tools通过.pth文件或环境变量加到Python路径里或者直接在需要用的虚拟环境中执行pip install traci sumolib这两者其实已经发布了PyPI包pip安装是更干净的方式。4. 安装配置时最常见的重复问题这里一次性说透4.1 环境变量配置了但不生效的三类原因我在各大技术社区里看到的环境变量不生效问题基本可以归为三类。第一类是修改后没有新开终端。Windows上修改环境变量后当前已打开的命令行窗口不会刷新环境变量必须关掉重开macOS和Linux上修改~/.bashrc后要执行source ~/.bashrc或者新开终端。这个原因产生的报障占比最高。第二类是系统变量和用户变量冲突。Windows上如果你在系统变量里设置了SUMO_HOME指向A版本又在用户变量里设置了SUMO_HOME指向B版本系统会优先使用用户变量。我曾经因为两个版本指向不同导致sumo --version显示的版本和netedit实际版本不一致运行脚本时找不到对应版本的配置文件。第三类是变量值多了空格或斜杠方向错误。Windows的环境变量值结尾多了一个空格或者用了正斜杠C:/Program Files/...有些工具能容错有些则不能。统一用反斜杠、不要加空格是最稳妥的写法。4.2 依赖库缺失导致的启动失败怎么定位Windows上sumo-gui启动时报The code execution cannot proceed because MSVCP140.dll was not found这是缺Visual C运行库。去微软官网下载vc_redist.x64.exe安装即可。如果你用源码编译链接时报cannot find -lxxx说明对应的开发库没有安装。用apt-file search或dnf provides来定位缺失的dev包是最高效的方法。Linux上还常见libgdal.so.XX: cannot open shared object file这类报错说明gdal库版本不匹配。如果是包管理器安装的试试apt install --reinstall sumo让依赖重新解析如果是源码编译的可能需要重新编译并确保LD_LIBRARY_PATH包含编译时使用的库路径。4.3 版本间兼容性问题不容小觑SUMO的配置文件和路网文件格式在不同大版本之间有时是不兼容的。比如1.14版本生成的路网在1.12版本上打开可能报错更早的0.32版本文件直接拿到1.20版本里也可能会丢字段。我个人的习惯是固定一个版本用于整个项目周期。如果确实需要升级要检查netconvert能否正常解析旧路网、duarouter能否读取旧的rou.xml百度搜索配置再检查仿真脚本里的TraCI代码是否调用了被废弃的API。官网的docs/ChangeLog页面会列出每个版本的破坏性变更升级前扫一遍这个列表能省不少事。4.4 一张表记住常见安装配置问题问题现象可能原因解决方案终端提示sumo不是内部或外部命令PATH未配置或未新开终端配置PATH并新开终端import traci报ModuleNotFoundErrorPython路径未包含tracipip install traci或配置PYTHONPATHsumo-gui打开后界面空白/闪退OpenGL/显卡驱动问题更新显卡驱动检查OpenGL支持源码编译报xercesc/... not found缺少xerces-c开发库安装libxerces-c-dev运行脚本报SUMO_HOME is not setSUMO_HOME未配置或指向错误重新配置并验证目录结构配置文件报Could not open network file路网文件路径错误或版本不兼容检查相对路径确认路网版本这些坑我基本都在实际项目中踩过。最想反复强调的依然是每次改完环境配置先新开一个终端再用sumo --version验证一次。这一步做到位至少能消掉一半以上的安装配置问题。5. 安装配置完成后先动手做一个小项目才算真正会用5.1 一段话搞懂SUMO的输入与输出文件体系SUMO仿真有三个最基础的文件类型路网文件.net.xml、需求文件.rou.xml、配置文件.sumocfg。示例中的run.sumocfg就是配置文件它告诉sumo去哪儿找路网和需求文件、仿真从第几秒开始到第几秒结束、输出哪些结果。我现在带你把这三个文件串起来跑通一个最小例子。5.2 用netedit快速画一个十字路口打开netedit方式很简单命令行执行netedit或直接双击启动。进入界面后我建议先选择Network模式默认就是在画布上拉出两条垂直交叉的路地道地形成十字路口。注意SUMO的车道是单向的你需要为每一条现实中的双向路分别画两条方向相反的车道。画完道路后系统会自动生成节点junction。如果你画的交叉口信号灯可以在节点属性里把Type改为traffic_light再设置相位方案。保存时netedit会默认导出.net.xml文件命名随意比如mynet.net.xml。很多新手在这里会纠结要不要画得很精细。我的建议是第一遍先追求能跑复杂交叉口、车道连接器、公交站点这些全都后面再加。能跑通完整流程比一次画一个完美的路网重要得多。5.3 生成交通需求并启动仿真有了路网文件还需要车辆文件。我不会手写xml去定义每条车辆的具体路径而是用随机交通流生成工具flowrouter.py或者直接用duarouter。更简单的方式是用python tools/randomTrips.py生成python $SUMO_HOME/tools/randomTrips.py -n mynet.net.xml -o mytrips.trips.xml -e 1000 --period 2 --random这个脚本会生成1000秒内、每2秒一辆车的随机出行需求。然后写一个配置文件demo.sumocfg内容如下?xml version1.0 encodingUTF-8? configuration input net-file valuemynet.net.xml/ route-files valuemytrips.trips.xml/ /input time begin value0/ end value1000/ /time /configuration最后执行sumo-gui -c demo.sumocfg你会看到界面里车辆沿路网行驶一辆接一辆从生成点驶向目的地。到这里你的SUMO环境已经彻底打通了接下来无论是学TraCI二次开发还是做信号优化实验都有了基础环境。我个人强烈建议你把官方仓库里的docs/examples整个翻一遍每个例子都跑一遍比看十篇教程都有效。5.4 配置完SUMO接下来值得关注的扩展方向安装配置只是SUMO之旅的第一步后面可以深入的方向很多。如果你做交通工程可以深入研究不同跟驰模型如Krauss、IDM的参数标定与对比如果你做自动驾驶仿真研究TraCI的不间断控制、传感器模拟、通信仿真插件如Plexe是核心如果你做信号控制研究libsumo的在线API和强化学习结合是当前热门方向。再往下你还会接触到网络级别的仿真、公交车调度、排放模型HBEFA、PHEMlight等高级模块但这些都要建立在SUMO环境稳定可用的基础上。先把基础打牢后面才飞得起来。写在最后反复折腾过SUMO的安装配置后我最大的体会有两点一是官方文档的installation章节值得先读三遍很多我以为是自己操作失误的问题其实文档里都有说明二是固定一个版本并做好环境隔离不同项目尽量用统一的SUMO版本和Python环境能避免大量版本冲突引起的时间浪费。建议你装好之后把今天文中提到的验证清单存成一份笔记未来换电脑、升级系统时直接照做能舒心不少。