如何解决NS3中运行Python程序时的‘ModuleNotFoundError: No module named 'ns3'’错误？

错误信息 #

Traceback (most recent call last):
 File "/home/alyaa/ns-allinone-3.40/ns-3.40/tes1.py", line 1, in <module>
  import ns3
ModuleNotFoundError: No module named 'ns3'
Command 'python3 tes1.py' returned non-zero exit status 1.

解决步骤 #

• 确认NS3已编译Python绑定
  NS3默认不会编译Python绑定，需要手动启用后重新编译：

  1. 进入NS3根目录：cd /home/alyaa/ns-allinone-3.40/ns-3.40
  2. 配置编译选项：./ns3 configure --enable-python-bindings
  3. 重新编译NS3：./ns3 build

• 配置Python环境变量
  编译完成后，ns3模块位于build/bindings/python目录，需要让Python能找到这个路径：

  • 临时生效（当前终端会话）：

    export PYTHONPATH=/home/alyaa/ns-allinone-3.40/ns-3.40/build/bindings/python:$PYTHONPATH
    

    之后再运行你的脚本：python3 tes1.py
  • 永久生效（添加到bash配置文件，比如~/.bashrc）：
    在文件末尾添加上述export命令，执行source ~/.bashrc生效
  • 或者直接在脚本开头添加路径：

    import sys
    sys.path.append('/home/alyaa/ns-allinone-3.40/ns-3.40/build/bindings/python')
    import ns3
    

• 检查Python版本兼容性
  ns-3.40对Python版本有要求（通常支持3.8及以上），执行python3 --version确认版本。如果版本不匹配，安装对应版本的Python后，重新执行./ns3 configure --enable-python-bindings和./ns3 build。

内容的提问来源于stack exchange，提问作者Alyaa Researcher Al_mula