Django Admin中模型字段不显示问题求助

核心排查步骤： #

• 确认应用已加入INSTALLED_APPS
  打开项目根目录的settings.py，检查你的应用（比如attendance）是否在INSTALLED_APPS列表中，示例：

  INSTALLED_APPS = [
      'django.contrib.admin',
      'django.contrib.auth',
      'django.contrib.contenttypes',
      'django.contrib.sessions',
      'django.contrib.messages',
      'django.contrib.staticfiles',
      # 必须添加你的应用
      'authentication',
      'course_management',
      'attendance',
  ]
  

  没添加的话，Django不会加载该应用的模型，Admin自然不会显示相关内容。

• 执行数据库迁移操作
  定义模型后必须同步数据库结构，运行以下命令：

  python manage.py makemigrations
  python manage.py migrate
  

  跳过迁移会导致Admin无法正确识别模型字段。

• 重启服务器并清除浏览器缓存
  开发服务器可能没加载最新配置，先重启：

  python manage.py runserver
  

  同时清除浏览器缓存，避免旧界面缓存导致显示异常。

• 检查Admin用户权限
  确保登录的Admin账号拥有对应模型的查看权限，用超级用户账号测试能快速排除权限问题。

优化建议（可选）： #

给模型添加__str__方法，让Admin里的对象显示更友好：

class Attendance(models.Model):
    user=models.ForeignKey(User,on_delete=models.CASCADE)
    course=models.ForeignKey(Course,on_delete=models.CASCADE)
    date=models.DateField()
    status=models.CharField(max_length=250)
    
    def __str__(self):
        return f"{self.user.username} - {self.course.name} - {self.date}"

你的admin.py代码本身没有问题，list_display配置正确，按上述步骤排查就能解决所有应用Admin不显示字段的问题。

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