Django 3 + Python 3环境下模型分文件存放引发NameError及循环导入问题求助

你遇到的这个问题是把Django模型拆分到单独文件时非常典型的循环导入场景——Poi、Tag和Layer三个模型互相依赖，直接导入会触发Python的循环导入错误，而用模块导入又没正确引用类导致NameError。我给你两种可靠的解决方案，都是适配Django 3和Python 3的：

方案一：使用字符串引用模型（Django官方推荐） #

Django支持用字符串格式的模型路径来代替直接导入的类，这样完全不需要在文件里导入依赖模型，从根源上避免循环导入。格式为'app_name.ModelName'，如果是同一个app下，也可以简化为'ModelName'，加上app名会更清晰。

修改各个模型文件： #

1. models/poi.py：移除对Tag和Layer的直接导入，改用字符串引用

from django.db import models

class Poi(models.Model):
    # 保留你的其他字段定义
    tags = models.ManyToManyField('poi.Tag', through='poi.Layer')
    
    def __str__(self):
        return self.name

2. models/tag.py：同样移除直接导入，改用字符串引用

from django.db import models

class Tag(models.Model):
    name = models.CharField(max_length=100)
    pois = models.ManyToManyField('poi.Poi', through='poi.Layer')
    
    def __str__(self):
        return self.name

3. models/layer.py：外键字段改用字符串引用模型

from django.db import models

class Layer(models.Model):
    poi = models.ForeignKey('poi.Poi', on_delete=models.CASCADE)
    tag = models.ForeignKey('poi.Tag', on_delete=models.CASCADE)

方案二：延迟导入（备选方案） #

如果你更倾向于使用类引用而不是字符串，可以尝试延迟导入——把导入语句放在模型定义之后，或者在需要使用的地方才导入，但这种方式不如方案一简洁：

from django.db import models

class Layer(models.Model):
    poi = models.ForeignKey('Poi', on_delete=models.CASCADE)
    tag = models.ForeignKey('Tag', on_delete=models.CASCADE)

# 在模型定义完成后再导入依赖模型
from .poi import Poi
from .tag import Tag

额外注意事项： #

• 你项目根目录下的models.py如果已经不再使用，建议删除，避免和models文件夹的内容混淆；
• 确保models/__init__.py的导入语句保持现状即可，Django会从这里加载所有注册的模型；
• 修改完成后，重新运行python3 manage.py makemigrations和python3 manage.py migrate，应该就能正常生成迁移文件了。

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