Python报ModuleNotFoundError：导入同目录uniqueid模块失败

以下是导致ModuleNotFoundError: No module named 'uniqueid'的常见原因：

• 导入方式错误：在Django应用的同目录模块间，应使用相对导入而非绝对导入。你当前用的import uniqueid属于绝对导入，Python会在系统路径（sys.path）中查找名为uniqueid的顶级模块，而非当前应用目录下的文件。正确的导入方式应为：

  from . import uniqueid
  

  或者直接导入目标函数：

  from .uniqueid import media_article_id
  

• 目录未被识别为Python包：检查media目录下是否存在__init__.py文件（可以是空文件）。虽然Python 3.3+支持无__init__.py的命名空间包，但Django对应用目录的识别依赖这个文件来标记为Python包，缺失它可能导致内部模块无法被正常导入。

• 文件名或路径拼写错误：确认uniqueid.py文件确实和models.py在同一目录下，且文件名完全匹配（注意大小写：Linux/macOS下文件名区分大小写，若文件名是UniqueID.py则会导入失败）。

• 运行环境的路径问题：如果是通过IDE或自定义命令运行项目，可能当前工作目录未被加入Python的sys.path。比如项目结构为myproject/media/，但运行时Python的搜索路径不包含myproject/，导致无法找到media下的子模块。此时可以检查sys.path的内容，或者确保以项目根目录为工作目录运行Django。

• 缓存文件干扰：删除media目录下的__pycache__文件夹，该文件夹存储了Python编译后的字节码文件，有时会导致模块加载异常。删除后重新运行项目即可。

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