终端运行Python脚本遇ImportError，PyCharm运行正常如何解决？

问题原因 #

PyCharm会自动把项目根目录（包含A的上级文件夹）加入Python的模块搜索路径sys.path，所以能正常识别A.B模块。但在终端直接执行python3 A/file.py时，Python仅将脚本所在的A目录加入sys.path，导致找不到顶级的A模块，触发ModuleNotFoundError。

具体解决方案 #

• 方法1：以模块方式运行脚本
  切换到项目根目录（即包含A的文件夹），执行以下命令：

  python3 -m A.file
  

  这种方式会让Python将项目根目录加入sys.path，符合模块导入的规范。

• 方法2：手动添加搜索路径到脚本
  在file.py的开头添加以下代码，动态将项目根目录加入sys.path：

  import sys
  import os
  # 获取当前脚本的绝对路径，再向上回溯到项目根目录（A的父目录）
  project_root = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
  sys.path.append(project_root)
  

  这样无论从哪个路径运行脚本，都能正确找到A模块。

• 方法3：设置环境变量PYTHONPATH
  在终端中先设置环境变量，指定项目根目录，再运行脚本：

  # Linux/macOS
  export PYTHONPATH=/path/to/your/project/root
  python3 A/file.py
  
  # Windows 命令提示符
  set PYTHONPATH=C:\path\to\your\project\root
  python3 A/file.py
  
  # Windows PowerShell
  $env:PYTHONPATH = "C:\path\to\your\project\root"
  python3 A/file.py
  

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