Django项目中跨同级目录导入Product类出现未解析引用错误求助

先确认基础配置 #

• 确保store是已注册的Django app：打开项目根目录的settings.py，检查INSTALLED_APPS列表里是否包含'store'，示例如下：

  INSTALLED_APPS = [
      'django.contrib.admin',
      'django.contrib.auth',
      'django.contrib.contenttypes',
      'django.contrib.sessions',
      'django.contrib.messages',
      'django.contrib.staticfiles',
      'store',  # 确认该行存在
      'basket',
  ]
  

• 检查目录结构：basket和store必须是同级文件夹，且每个文件夹下都要有__init__.py文件（空文件即可，Python 3.3+虽自动识别包，但Django环境下建议保留）。

导入写法验证 #

• 优先用绝对导入：直接写from store.models import Product，很多时候IDE的“unresolved reference”是静态检查误报，先运行项目测试是否真的报错。如果项目能正常运行，只是IDE提示错误，无需修改代码。
• 如果绝对导入运行时报错，再试相对导入：若目录结构为项目根目录/basket/和项目根目录/store/，在basket/views.py中使用：

  from ..store.models import Product
  

  若提示“过度向上遍历”，说明basket所在层级不对——比如basket在子文件夹（如apps/basket/）中，需对应层级调整相对导入，比如from .store.models import Product（当basket和store都在apps文件夹下时）。

修复IDE静态检查误报 #

如果项目运行正常但IDE持续提示错误，以PyCharm为例：

• 右键点击项目根目录，选择Mark Directory as -> Sources Root
• 打开File -> Invalidate Caches...，选择Invalidate and Restart，让IDE重新索引项目

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