PyFoam安装后import报ImportError: No module named PyFoam如何解决

这个报错的核心原因是：执行pip安装时对应的Python解释器，和运行test.py脚本时调用的Python解释器环境不匹配，或是用户目录的站点包路径未被Python识别。

排查步骤 #

• 确认pip绑定的Python环境
  执行命令查看pip对应的Python版本和安装路径：

  pip --version
  

  从已有的返回结果看，当前pip会把包装到~/.local/lib/python3.8/site-packages路径下，对应Python 3.8版本。
• 确认运行脚本用的Python环境
  执行以下命令查看默认python命令的版本和路径：

  python --version
  which python
  

  • 如果返回版本是Python 2.x，或是Python 3.8以外的3.x版本，就能直接定位问题：你给Python3.8装了PyFoam，但跑脚本用的是其他版本的Python，自然找不到对应模块。
  • 如果返回确实是Python3.8，继续执行以下命令检查Python的模块搜索路径是否包含用户目录的站点包：

    python -c "import sys; print('\n'.join(sys.path))"
    

    如果输出结果里没有~/.local/lib/python3.8/site-packages，就是路径未被识别导致的报错。

对应解决方法 #

• 多Python版本不匹配的情况
  不要用笼统的pip/python命令，直接指定Python3.8来完成安装和运行操作，从根源避免装错环境：

  # 给Python3.8安装PyFoam
  python3.8 -m pip install --user PyFoam
  # 用Python3.8运行测试脚本
  python3.8 test.py
  

  用[python版本号] -m pip的方式调用pip，能保证包100%安装到对应版本的Python环境中，不会出现路径错位。

• 用户站点包路径未识别的情况
  临时修复可以在test.py的导入语句前，手动把包路径加入搜索列表：

  import sys
  sys.path.append("/home/你的系统用户名/.local/lib/python3.8/site-packages")
  import PyFoam
  

  永久修复可以把用户站点包路径加入环境变量：编辑家目录下的.bashrc（使用zsh则编辑.zshrc），在末尾添加一行：

  export PYTHONPATH="$HOME/.local/lib/python3.8/site-packages:$PYTHONPATH"
  

  保存后执行source ~/.bashrc让配置生效即可。

内容的提问来源于stack exchange，提问作者Yana