2. SUMO安装与配置:Windows/Linux/MacOS安装、环境变量配置、验证安装、常见安装问题

说实话,SUMO的安装是我见过最「亲民」的交通仿真工具之一。但再亲民的工具,第一次装也容易踩坑。我记得最早带团队做项目时,有个新同事装了一整天没搞定,最后发现是环境变量没配好。嗯,这节课我就把各个平台的安装细节掰开揉碎讲清楚。

核心要点:SUMO支持Windows、Linux、MacOS三大平台,安装方式分为「二进制包安装」和「源码编译安装」两种。对于绝大多数用户,我强烈建议用二进制包——省心、省力、不出错。

2.1 Windows平台安装

Windows用户最幸福,直接下载安装包就行。我个人习惯去SUMO官网的下载页面,找Windows Installer版本。

  1. 下载安装包:访问 sumo.dlr.de 官网,找到「Download」页面
  2. 运行安装程序:双击exe文件,一路Next
  3. 注意安装路径:我建议不要有中文和空格,比如 C:\SUMO
  4. 勾选环境变量:安装过程中有个选项「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手动配置:

  1. 右键「此电脑」→「属性」→「高级系统设置」
  2. 点击「环境变量」
  3. 在「系统变量」中找到Path,双击编辑
  4. 添加SUMO的bin目录,比如 C:\SUMO\bin
  5. 再添加一个 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安装与配置知识体系 Windows安装 Linux安装 MacOS安装 二进制安装包 apt/yum/源码 Homebrew/dmg 环境变量配置(PATH + SUMO_HOME) 验证安装(sumo --version) 常见问题排查 环境变量检查 安装 → 配置 → 验证 → 使用,四步走完SUMO入门

这张图把整个安装流程串起来了。你从左边选你的操作系统,然后选安装方式,配好环境变量,验证通过,就完事了。如果中间出问题,右边那两个红色框就是你的救命稻草。

💡 最后说一句:安装这事,一次配好,后面就一劳永逸了。我建议你装完后把 sumo --version 的结果截个图保存下来,以后换电脑或者重装系统时,对照着来,不会出错。

可可精品资料库