2. SUMO安装与配置:Windows/Linux/MacOS安装、环境变量配置、验证安装、常见安装问题
说实话,SUMO的安装是我见过最「亲民」的交通仿真工具之一。但再亲民的工具,第一次装也容易踩坑。我记得最早带团队做项目时,有个新同事装了一整天没搞定,最后发现是环境变量没配好。嗯,这节课我就把各个平台的安装细节掰开揉碎讲清楚。
核心要点:SUMO支持Windows、Linux、MacOS三大平台,安装方式分为「二进制包安装」和「源码编译安装」两种。对于绝大多数用户,我强烈建议用二进制包——省心、省力、不出错。
2.1 Windows平台安装
Windows用户最幸福,直接下载安装包就行。我个人习惯去SUMO官网的下载页面,找Windows Installer版本。
- 下载安装包:访问 sumo.dlr.de 官网,找到「Download」页面
- 运行安装程序:双击exe文件,一路Next
- 注意安装路径:我建议不要有中文和空格,比如
C:\SUMO - 勾选环境变量:安装过程中有个选项「Add SUMO to PATH」,一定要勾上
⚠️ 我曾经踩过的坑:安装时没勾选环境变量,结果命令行里敲sumo死活找不到命令。后来手动配了半天,还不如重装一遍来得快。所以,安装时一定记得勾那个选项。
2.2 Linux平台安装
Linux下安装SUMO其实最灵活。我平时用Ubuntu比较多,直接apt搞定。但CentOS用户就得稍微折腾一下了。
Ubuntu/Debian系:
sudo apt update
sudo apt install sumo sumo-tools sumo-doc
CentOS/RHEL系:
sudo yum install epel-release
sudo yum install sumo
💡 小技巧:Linux下安装完成后,用 which sumo 检查一下。如果没找到,多半是源里没有最新版。这时候我建议去官网下载源码自己编译,或者添加PPA源。
2.3 MacOS平台安装
Mac用户用Homebrew最方便。我在MacBook上就是这么装的,一条命令搞定。
brew install sumo
如果你没有Homebrew,先去装一个。或者你也可以去官网下载dmg安装包,双击安装就行。
注意:MacOS的SIP(系统完整性保护)有时会阻止SUMO写入某些目录。如果遇到权限问题,可以试试把SUMO安装到用户目录下。
2.4 环境变量配置
环境变量这东西,说白了就是告诉系统「SUMO在哪」。配好了,你在任何目录下都能直接敲sumo命令。
Windows手动配置:
- 右键「此电脑」→「属性」→「高级系统设置」
- 点击「环境变量」
- 在「系统变量」中找到Path,双击编辑
- 添加SUMO的bin目录,比如
C:\SUMO\bin - 再添加一个
SUMO_HOME变量,值为C:\SUMO
Linux/MacOS配置:
编辑 ~/.bashrc 或 ~/.zshrc,添加以下内容:
export SUMO_HOME=/usr/share/sumo
export PATH=$PATH:$SUMO_HOME/bin
然后执行 source ~/.bashrc 使其生效。
⚠️ 我遇到过的情况:有次配完环境变量,重启终端后还是找不到sumo。后来发现是拼写错了——把SUMO写成了SUMO_HOME少了个字母。你想想看,这种低级错误排查起来多浪费时间。所以配完后一定要验证。
2.5 验证安装
装没装好,跑个命令就知道了。打开终端或命令行,输入:
sumo --version
如果看到类似 SUMO Version 1.18.0 的输出,恭喜你,安装成功。
我还会多跑一个测试:
sumo-gui
这个命令会启动SUMO的图形界面。如果界面能正常打开,说明所有组件都装好了。
💡 验证清单:
- 命令行能执行
sumo --version - 能启动
sumo-gui图形界面 echo $SUMO_HOME能输出正确路径(Linux/Mac)- Python能导入
traci库(如果装了Python接口)
2.6 常见安装问题
这些年我帮不少人排查过SUMO安装问题,总结下来就这几类:
| 问题现象 | 可能原因 | 解决方案 |
|---|---|---|
| 「sumo不是内部或外部命令」 | 环境变量没配好 | 检查Path是否包含SUMO的bin目录 |
| 缺少DLL文件(Windows) | VC++运行库未安装 | 安装Visual C++ Redistributable |
| sumo-gui启动闪退 | 显卡驱动或OpenGL问题 | 更新显卡驱动,或使用 sumo --no-gui |
| Python导入traci失败 | Python路径未配置 | 将SUMO的tools目录加入PYTHONPATH |
| Linux下编译报错 | 缺少依赖库 | 安装build-essential、libxerces-c-dev等 |
我的经验之谈:遇到问题先别慌。80%的安装问题都是环境变量没配对,或者路径里有中文。剩下的20%,去SUMO的官方论坛搜一下,基本都有答案。我曾经花了一下午折腾一个编译错误,最后发现是g++版本太旧——升级一下就解决了。
2.7 知识体系总览
下面这张图是我自己整理的SUMO安装知识体系,你一看就明白整个流程了:
这张图把整个安装流程串起来了。你从左边选你的操作系统,然后选安装方式,配好环境变量,验证通过,就完事了。如果中间出问题,右边那两个红色框就是你的救命稻草。
💡 最后说一句:安装这事,一次配好,后面就一劳永逸了。我建议你装完后把 sumo --version 的结果截个图保存下来,以后换电脑或者重装系统时,对照着来,不会出错。
可可精品资料库