第2章：SUMO环境搭建
好了，咱们正式开始动手。上一章聊了SUMO能干什么，这一章就把它装到你的电脑上。
环境搭建这事儿，说难不难，说简单吧——我见过不少新手卡在这一步。说白了，就是下载、安装、配环境变量、验证。四步走完，后面就顺畅了。
2.1 下载SUMO
先到官网去下载。我个人习惯直接去 sumo.dlr.de 的官方页面，别去第三方网站下，版本混乱不说，还可能带广告。
目前稳定版是 1.19.0（写这章时的版本，你下载时以官网为准）。
下载时注意你的操作系统：
| 操作系统 | 下载文件 | 说明 |
|---|---|---|
| Windows | sumo-win64-1.19.0.msi | 直接双击安装，推荐 |
| Windows | sumo-win64-1.19.0.zip | 解压版，适合绿色软件爱好者 |
| Linux (Ubuntu) | sudo apt install sumo | 一行命令搞定 |
| macOS | brew install sumo | Homebrew用户首选 |
2.2 安装过程
双击 .msi 文件，一路 Next 就行。但有几个地方我提醒你注意：
- 安装路径：别带中文和空格。比如
C:\Program Files\SUMO可以，但C:\交通仿真\SUMO不行。我吃过这个亏，后来某些Python脚本读路径时直接报错。 - 组件选择：默认全选就行。里面包含了 sumo-gui（图形界面）、netedit（路网编辑器）、traci（Python接口）等核心工具。
- 安装时间：大概1-2分钟。如果卡住，检查一下是不是杀毒软件在拦截。
Linux用户更简单：
sudo apt update
sudo apt install sumo sumo-tools sumo-docmacOS用户：
brew install sumo2.3 环境变量配置（Windows重点）
嗯，这里要仔细看。环境变量配不好，后面所有操作都跑不起来。
步骤很简单：
- 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
- 在「系统变量」里找到
Path，双击编辑 - 点击「新建」，添加SUMO的bin目录路径。比如：
C:\Program Files\SUMO\bin - 再新建一个变量
SUMO_HOME，值设为SUMO的根目录，比如C:\Program Files\SUMO - 点击确定，保存
为什么要配 SUMO_HOME？
很多SUMO工具（比如 netedit、sumo-gui）启动时会读取这个变量，来找配置文件。我曾经没配这个，结果 netedit 打不开，报错说找不到资源文件。折腾了半小时才发现是环境变量漏了。
配完之后，重启一下命令行窗口（或者直接重启电脑，更保险）。
2.4 验证安装是否成功
这一步不能省。我见过有人装完觉得「应该没问题」，结果写代码时发现 sumo 命令根本跑不了。
打开命令行（cmd或PowerShell），输入：
sumo --version如果看到类似这样的输出，说明安装成功：
SUMO Version 1.19.0
Build features: ...再验证一下图形界面：
sumo-gui应该会弹出一个空白的地图窗口。如果报错，检查一下显卡驱动或者OpenGL支持。
最后验证一下Python接口（如果你要用TraCI的话）：
python -c "import traci; print('TraCI OK')"如果报错 ModuleNotFoundError，说明Python没找到SUMO的库。这时候需要把 SUMO_HOME\tools 目录加到Python的搜索路径里。我一般这样处理：
set PYTHONPATH=%SUMO_HOME%\tools;%PYTHONPATH%或者直接在Python代码里加：
import sys
sys.path.append(r'C:\Program Files\SUMO\tools')docs\examples 或 data\examples 里，有个 hello_sumo 的案例。双击运行，能看到一辆小车在跑。这比干看版本号更有成就感。
2.5 常见问题与避坑
我整理了几个新手最容易踩的坑：
- 「sumo 不是内部或外部命令」：环境变量没配好。检查 Path 里有没有 bin 目录。
- 「无法启动此程序，因为计算机中丢失 MSVCP140.dll」：缺少VC++运行库。去微软官网下载安装 Visual C++ Redistributable for Visual Studio 2015-2022。
- sumo-gui 闪退：显卡驱动太旧，或者OpenGL版本太低。更新驱动试试。
- Python导入traci报错：没设置 PYTHONPATH，或者Python版本不对（SUMO 1.19.0 支持 Python 3.7+）。
C:\Program Files (x86)\SUMO，结果某些脚本解析路径时把空格当成了分隔符，直接报错。从那以后，我所有仿真工具都装在无空格路径下。
2.6 本章知识体系
下面这张图帮你理清SUMO环境搭建的完整流程：
这张图把整个流程串起来了。你跟着走一遍，基本不会出问题。
2.7 小结
环境搭建就这些内容。下载、安装、配环境变量、验证——四步走完，SUMO就跑起来了。
我个人觉得，配环境变量是最容易出岔子的环节。你如果卡住了，优先检查 Path 和 SUMO_HOME 这两个变量。另外，安装路径别带中文和空格，这个坑我替你们踩过了。
好了，装好之后，下一章咱们就开始用SUMO跑第一个仿真。到时候你会看到一辆小车在屏幕上动起来，那感觉还是挺爽的。