django 模型已定义并注册到 admin，但字段仍不显示在后台管理界面——这通常是因为模型变更未同步到数据库，需执行 makemigrations 和 migrate 命令完成数据库迁移。

django 模型已定义并注册到 admin，但字段仍不显示在后台管理界面——这通常是因为模型变更未同步到数据库，需执行 makemigrations 和 migrate 命令完成数据库迁移。

在 Django 开发中，models.py 中定义的模型类仅描述了数据结构，并不会自动创建或更新数据库表。即使你已在 admin.py 中正确注册了 ModelAdmin 类（如设置了 list_display），若对应的数据表尚未在数据库中生成，Django Admin 就无法读取、展示这些字段——此时页面可能空白、报错，或仅显示默认的“Object”条目。

你提供的代码逻辑完全正确：

• Attendance 模型包含 ForeignKey、DateField 和 CharField，结构清晰；
• admin.py 中自定义 AttendanceAdmin 并显式注册，list_display 也覆盖了全部关键字段。

✅ 但缺失的关键步骤是：将模型变更落地到数据库。

请按顺序执行以下两条命令（在项目根目录下，确保已激活虚拟环境）：

Django Unfold

提供使用 django-unfold (v0.56+) 构建高级 Django 管理界面的专业指导。当用户提及 django-unfold、unfold admin 等内容时使用此技能。

下载

python manage.py makemigrations
python manage.py migrate

• makemigrations 会扫描所有 models.py 变更，生成迁移文件（位于 your_app/migrations/0001_initial.py 等）；
• migrate 则将这些变更实际应用到数据库（如 SQLite、PostgreSQL），创建 attendance 表及对应字段。

? 小贴士：

• 首次创建模型后必须执行迁移，否则 syncdb（旧版命令）已废弃，migrate 是唯一生效方式；
• 若修改了已有模型（如新增字段、改 max_length），同样需重新 makemigrations + migrate；
• 执行后可运行 python manage.py showmigrations 查看迁移状态，确认 attendance 相关迁移是否为 [X]（已应用）；
• 若提示 “No changes detected”，请检查是否在正确的 app 下修改了 models.py，或尝试 makemigrations your_app_name 指定应用。

完成迁移后，重启 Django 开发服务器（python manage.py runserver），访问 /admin/ → 进入 Attendance 列表页，即可看到 user、course、date、status 四列完整展示——你的 Admin 配置已真正生效。

总结：Django Admin 的显示依赖于底层数据库结构的存在与一致性。写好模型 ≠ 数据库就绪；注册 Admin ≠ 字段自动可见。牢记「定义 → 迁移 → 启用」三步铁律，就能避开 90% 的新手 Admin 显示问题。