PyQt5运行报错：No module named 'Section3' 如何解决？

嘿，我刚帮几个PyQt5新手解决过类似的问题，别着急，这大概率是Python模块路径或者文件夹结构的问题，咱们一步步来排查：

1. 先确认你的文件夹结构是否符合要求 #

Python要识别Section3作为一个可导入的模块，必须满足两个核心条件：

• 存在名为Section3的文件夹，里面有Dialog.py文件（注意文件名和大小写要和导入语句完全匹配）
• Section3文件夹里必须有一个__init__.py文件（可以是空文件，用来告诉Python这是一个合法的包）

正确的项目结构应该像这样：

你的项目根目录/
    Section3/
        __init__.py
        Dialog.py
    你的主运行脚本.py  # 就是你写import语句的那个文件，比如main.py

2. 手动把项目根目录加入Python搜索路径 #

如果你的主脚本不在项目根目录，或者Python没自动识别到根目录，你可以手动添加路径。在你的主脚本最开头加上这段代码：

import sys
from pathlib import Path

# 获取当前脚本所在的文件夹，假设主脚本在项目根目录下
project_root = Path(__file__).parent
# 如果主脚本在子文件夹里（比如src/main.py），就改成Path(__file__).parent.parent
sys.path.append(str(project_root))

这段代码会把项目根目录加入Python的模块搜索列表，这样它就能找到Section3包了。

3. 核对视频教程里的文件相对位置 #

回到你看的视频05:52处，仔细确认教程里的Section3文件夹和主脚本的相对位置。比如教程里是不是把主脚本放在和Section3同级的目录下？如果你的脚本放错了位置（比如不小心放到了Section3文件夹里面），那自然会找不到模块。

4. 检查大小写匹配问题 #

Python在Linux和macOS系统下对文件名/文件夹名的大小写是严格敏感的，如果你的文件夹叫section3（全小写），但导入语句写的是Section3，就会直接报错。Windows系统虽然不敏感，但建议保持名称完全一致，避免后续跨平台开发出问题。

按照这几步排查下来，应该就能解决这个导入错误啦！

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