SUMO项目在macOS上的安装与使用问题解析

背景介绍

SUMO(Simulation of Urban MObility)是一款开源的交通仿真软件，广泛应用于城市交通规划和研究领域。在macOS系统上安装和使用SUMO时，用户可能会遇到各种依赖问题和路径配置问题。

常见问题分析

1. Xerces-C库加载失败

许多用户在macOS上安装SUMO后运行时遇到Xerces-C库加载错误，提示找不到libxerces-c-3.2.dylib文件。这是由于Homebrew安装的Xerces-C版本(3.3.0)与SUMO期望的版本(3.2)不匹配导致的。

2. 命令行工具不可用

虽然GUI应用可以正常启动，但netconvert等命令行工具无法使用。这是因为安装路径没有正确添加到系统PATH环境变量中。

3. 场景向导启动失败

SUMO Scenario Wizard应用启动时可能报错，提示找不到Python脚本文件。这是由于脚本中的路径配置不正确导致的。

解决方案

推荐安装方式

官方已决定逐步弃用Homebrew安装方式，推荐以下两种替代方案：

1. 使用macOS安装包
   官方提供了专门的macOS安装程序，该程序为自包含版本，无需额外安装依赖项。安装后会在/Applications目录下创建应用启动器，并将主程序安装在/Library/Frameworks/EclipseSUMO.framework目录中。

2. 从源代码编译
   对于需要自定义功能的用户，可以从源代码编译SUMO。macOS上的编译过程相对简单，可以参考官方提供的构建工作流文件。

环境变量配置

要使命令行工具正常工作，需要将SUMO的bin目录添加到PATH环境变量中。具体路径为：

/Library/Frameworks/EclipseSUMO.framework/Versions/Current/EclipseSUMO/share/sumo/bin

可以在.zshrc文件中添加以下内容：

export PATH="/Library/Frameworks/EclipseSUMO.framework/Versions/Current/EclipseSUMO/share/sumo/bin:$PATH"

场景向导修复

如果SUMO Scenario Wizard无法启动，可以修改其启动脚本。找到文件：

/Applications/SUMO Scenario Wizard.app/Contents/MacOS/SUMO Scenario Wizard/SUMO Scenario Wizard.sh

将其内容替换为：

#!/bin/bash
export SUMO_HOME="/Library/Frameworks/EclipseSUMO.framework/Versions/Current/EclipseSUMO/share/sumo"
python3 $SUMO_HOME/tools/osmWebWizard.py || python3 $SUMO_HOME/tools/osmWebWizard.py &

总结

在macOS上使用SUMO时，推荐使用官方提供的安装包而非Homebrew安装。安装后需要注意正确配置环境变量，特别是PATH和SUMO_HOME变量。对于应用启动问题，可以通过修改启动脚本中的路径配置来解决。随着官方对macOS支持的不断完善，未来安装和使用体验将会更加顺畅。