PyQt5项目运行报错ModuleNotFoundError：找不到toolbar模块

问题场景 #

项目目录结构：

根目录/
├── app.py
└── ui_components/
    ├── main_window.py
    └── toolbar.py

运行根目录下的app.py时，main_window.py导入toolbar抛出ModuleNotFoundError: No module named 'toolbar'，将app.py移入ui_components目录后可正常运行，当前使用虚拟环境。

问题原因 #

从根目录运行app.py时，Python的模块搜索路径默认包含当前运行目录（即根目录）。main_window.py位于ui_components目录，它尝试导入toolbar时，Python会在根目录下查找toolbar.py，而非ui_components目录，因此找不到目标模块。

解决方案 #

方法1：使用相对导入（推荐）

1. 在ui_components目录下创建空的__init__.py文件，将该目录标记为Python包。
2. 修改main_window.py中的导入语句为相对导入：

from . import toolbar

3. 修改app.py中的导入语句为绝对导入：

from ui_components import main_window
# 或按需导入具体对象：from ui_components.main_window import MainWindow

这种方式依赖Python的包结构，无论从哪个目录启动app.py都能正确定位模块，适合长期维护的项目。

方法2：临时添加模块搜索路径

在main_window.py的开头添加以下代码，将当前文件所在目录加入Python的模块搜索路径：

import sys
import os

current_dir = os.path.dirname(os.path.abspath(__file__))
if current_dir not in sys.path:
    sys.path.append(current_dir)

import toolbar

该方法无需调整包结构，但可能引发路径冲突，仅适合小型临时项目使用。

方法3：调整运行方式（临时方案）

如果不想修改代码，可在根目录下通过-m参数以模块方式运行（需调整app.py逻辑到包内），或切换工作目录到ui_components后运行app.py，但这种方式灵活性差，不推荐作为长期解决方案。

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