PyCharm导入语句正常，终端报ModuleNotFoundError问题求助

问题梳理 #

你的项目结构如下：

project
  /package_one
    /dir_one
     __init__.py   
     Class_one.py
   __init__.py
   main.py
   /Frontend
     ...
   /Backend
     ...(需从package_one导入)

需要实现两个目标：

1. Backend模块能将package_one作为库导入
2. package_one下的main.py可以单独运行

当前遇到的问题：

• PyCharm中两种导入方式都能正常运行，但终端执行python3 -m main.py或python3 main.py时，出现ModuleNotFoundError: No Module named 'package_one'
• 尝试修改工作目录、设置PYTHONPATH后无效

可行解决方案 #

方案1：使用正确的模块运行命令 #

核心：不要给-m参数加.py后缀，且从项目根目录运行
进入project目录，执行：

python3 -m package_one.main

这种方式会让Python自动将项目根目录加入sys.path，从而正确识别package_one作为顶级包，不管是内部导入还是Backend的跨包导入都能正常工作。

方案2：修改main.py的路径配置，兼容多种运行方式 #

在main.py的最顶部添加以下代码，手动将项目根目录加入Python的搜索路径：

import sys
import os
# 获取当前文件的父目录（即package_one），再取父目录就是project根目录
project_root = os.path.abspath(os.path.dirname(os.path.dirname(__file__)))
if project_root not in sys.path:
    sys.path.insert(0, project_root)

之后保持from package_one.dir_one import Class_one的导入方式即可，不管是在package_one目录下直接运行python3 main.py，还是从项目根目录运行，都能正确找到模块。

方案3：改用相对导入优化包内部引用 #

将package_one/__init__.py中的导入改为相对导入：

from .dir_one import Class_one

main.py中如果仅用于包内运行，也可以用相对导入：

from .dir_one import Class_one

但这种方式只能通过python3 -m package_one.main运行，不能直接执行python3 main.py（直接运行时main.py不被视为包的一部分，相对导入会失效）。

方案4：正确配置PYTHONPATH #

之前的PYTHONPATH可能没设置到正确的路径，进入project目录后执行：

export PYTHONPATH=$(pwd)

之后再运行python3 package_one/main.py或python3 -m package_one.main，Python就能识别到package_one包了。

为什么之前的方法无效？ #

• sys.chdir('..')只是修改了当前工作目录，但Python的模块搜索路径sys.path不一定包含这个目录，因此无法找到包。
• 如果PYTHONPATH设置的不是project根目录，而是其他路径，自然无法定位到package_one。

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