PyCharm无报错但运行时出现ModuleNotFoundError找不到image_downloader模块

• 第一步先确认运行环境的模块搜索路径：在报错的文件头部加入代码import sys; print(sys.path)，运行后检查输出的路径列表中是否包含downloaders目录的绝对路径。如果不存在，即可定位为运行时模块搜索路径缺失问题。
• 检查PyCharm运行配置：打开当前脚本的运行配置页，确认「Add content roots to PYTHONPATH」「Add source roots to PYTHONPATH」两个选项处于勾选状态，PyCharm默认勾选这两个选项实现IDE内的路径补全和导入检查，误取消会导致IDE和运行环境表现不一致。
• 检查项目包配置：确认downloaders目录下是否存在__init__.py文件，Python 3.3+虽支持隐式命名空间包，但部分运行环境仍需要显式的__init__.py文件识别目录为可导入的包；同时确认downloaders目录是否被PyCharm标记为Source Root（标记后目录会显示为蓝色）。
• 校验Python解释器一致性：分别查看PyCharm项目配置的解释器路径，以及终端运行时使用的解释器路径（Linux/macOS执行which python，Windows执行where python），如果二者不一致（比如IDE用了项目虚拟环境，终端调用了全局解释器），也会触发该异常。
• 临时修复方案：在导入image_downloader的代码前加入以下内容，手动将当前文件所在目录加入模块搜索路径：

import sys
from pathlib import Path
sys.path.append(str(Path(__file__).parent.resolve()))

• 长期规范修复方案二选一：
  1. 改用相对导入：将import image_downloader修改为from . import image_downloader，注意使用该写法时不能直接在downloaders目录下运行该文件，需要从项目根目录以包调用的形式执行
  2. 改用绝对导入：将import image_downloader修改为from downloaders import image_downloader，同时确保项目根目录已加入运行时的sys.path，兼容性更强。

内容的提问来源于stack exchange，提问作者Marie M.