1. 当Python找不到TraCI模块时发生了什么第一次在Python里输入import traci就报错的时候我盯着那个红色的No module named traci发呆了五分钟。这就像你拿着钥匙却打不开自家门锁——明明SUMO都安装好了为什么Python就是不认这个模块呢后来才发现这其实是Python模块搜索路径和SUMO安装目录之间的断联问题。Python寻找模块的机制很有意思。当你执行import语句时它会按照固定顺序搜索这些位置首先检查当前目录然后查看内置模块最后遍历sys.path列表里的所有路径。而SUMO的TraCI模块默认安装在SUMO_HOME/tools目录下这个路径通常不在Python的搜索范围内。就好比你家的备用钥匙放在车库工具箱里但开锁师傅只检查门口地毯和钥匙扣当然找不到。我遇到过最典型的情况是在PyCharm里运行正常到命令行就报错或者反过来。这种薛定谔的import现象往往是因为不同环境下的Python路径配置不同。比如PyCharm可能自动添加了项目根目录到路径而命令行环境则需要手动配置。2. 环境变量配置给系统指条明路2.1 配置SUMO_HOME环境变量这个步骤就像给快递员写清楚你家门牌号。在Windows上我习惯同时设置用户变量和系统变量避免权限问题。具体操作右键此电脑 → 属性 → 高级系统设置 → 环境变量在用户变量和系统变量中都新建SUMO_HOME变量值设置为SUMO的安装路径比如C:\SUMO验证是否成功有个小技巧在cmd里连续执行这两个命令echo %SUMO_HOME% dir %SUMO_HOME%\bin\sumo-gui.exe第一个命令应该显示SUMO路径第二个命令应该能列出sumo-gui程序文件。2.2 把SUMO加入系统PATH光有门牌号还不够得把具体路线也告诉系统。找到SUMO安装目录下的bin和tools文件夹把它们的完整路径添加到系统PATH变量中。我建议加到用户PATH而不是系统PATH避免影响其他用户。有个容易踩的坑PATH里的路径要用分号隔开但最后一个路径后面不能加分号。曾经因为多写了个分号折腾了我两小时。验证PATH是否生效可以这样path | find SUMO如果没输出结果说明PATH设置有问题。3. 创建.pth文件的正确姿势3.1 找到你的Python站点包目录首先得搞清楚你的Python环境把第三方库装在哪。用这个小脚本就能找到import site print(site.getsitepackages())对于Anaconda用户路径通常是Anaconda3\envs\环境名\Lib\site-packages。我建议专门为SUMO项目创建独立环境避免污染base环境。3.2 编写traci.pth文件在站点包目录下新建traci.pth文件内容就是SUMO的tools目录路径。注意三点路径要写绝对路径不需要引号确保路径真实存在我习惯用Python来创建这个文件避免编码问题with open(traci.pth, w) as f: f.write(rC:\SUMO\tools)3.3 常见.pth文件陷阱有时候.pth文件不生效可能是这些原因文件名后缀误写成.pt或.txt文件编码不是UTF-8路径中包含中文或特殊字符Python没有读取权限可以用这个命令检查.pth文件是否被加载python -c import site; print(site.getsitepackages())4. 关键一步复制traci文件夹4.1 为什么.pth还不够.pth文件只是告诉Python去哪里找模块但SUMO的traci模块有点特殊——它其实是个Python包包含__init__.py的文件夹。在Windows上仅靠.pth文件有时会导致导入失败特别是当SUMO安装在有空格的路径中时比如Program Files。4.2 正确的复制操作找到SUMO安装目录下的tools\traci文件夹整个复制到Python的site-packages目录。这里有个细节复制前先删除旧的traci文件夹如果有的话避免缓存问题。我推荐用robocopy命令来做这个操作它能保留文件属性robocopy %SUMO_HOME%\tools\traci %PYTHONPATH%\Lib\site-packages\traci /E其中%PYTHONPATH%是你的Python环境路径。4.3 验证复制结果复制完成后检查这些文件是否存在site-packages/traci/__init__.pysite-packages/traci/_traci.pyd(Windows) 或_traci.so(Linux)可以用这个Python代码快速验证import traci print(traci.__file__) # 应该显示site-packages下的路径5. 处理sumolib和其他工具包sumolib的配置就简单多了因为它不需要运行时链接库。直接把SUMO工具目录下的sumolib文件夹复制到site-packages就行。不过要注意版本匹配问题——SUMO版本和sumolib版本必须一致。我习惯用这个命令批量复制所有工具包robocopy %SUMO_HOME%\tools %PYTHONPATH%\Lib\site-packages /E /XF *.cpp *.h/XF参数排除C源码文件减少不必要的文件复制。6. 虚拟环境下的特殊处理如果你使用conda或venv创建的虚拟环境有几点额外要注意确保.pth文件放在虚拟环境的site-packages目录而不是全局目录激活虚拟环境后再进行复制操作对于conda可能需要先执行conda develop %SUMO_HOME%\tools在Jupyter notebook中使用时记得检查kernel对应的Python路径是否正确。可以用import sys print(sys.executable)确认是否指向你的虚拟环境。7. 跨平台配置要点在Linux/macOS上配置步骤类似但有几个差异点环境变量写入~/.bashrc或~/.zshrcexport SUMO_HOME/opt/sumo export PYTHONPATH$SUMO_HOME/tools:$PYTHONPATH.pth文件放在dist-packages而非site-packages可能需要先安装依赖sudo apt-get install python3-devWindows用户特别注意路径分隔符要用双反斜杠\\或原始字符串前缀r。我曾经因为路径问题debug到凌晨三点血的教训啊。8. 终极验证方案配置完成后建议用这个完整的测试脚本验证import traci import sumolib def test_connection(): traci.start([sumo, --version]) print(SUMO version:, traci.getVersion()) traci.close() if __name__ __main__: test_connection() print(sumolib version:, sumolib.__version__) print(所有模块导入成功)如果遇到SSL相关错误可能需要额外设置import os os.environ[SUMO_HOME] C:\\SUMO最后分享一个排查导入问题的万能命令python -v -c import traci 21 | grep traci这个-v参数会让Python打印所有导入过程的详细信息像侦探一样追踪模块查找路径。