django 模型在 admin 后台未显示字段，通常是因为数据库迁移未执行——模型已定义、admin 已注册，但表结构未同步到数据库，导致 admin 无法读取或渲染对应字段。
django 模型在 admin 后台未显示字段，通常是因为数据库迁移未执行——模型已定义、admin 已注册，但表结构未同步到数据库，导致 admin 无法读取或渲染对应字段。
当你完成模型（models.py）编写并配置好 admin.py 后，Django 并不会自动将模型结构写入数据库。它需要显式执行迁移命令来生成并应用数据库变更。你当前的 Attendance 模型虽已定义外键、日期和字符字段，并在 Admin 中通过 list_display 指定了展示列，但如果对应的数据库表尚未创建或缺少字段，Django Admin 将无法识别这些字段，甚至可能静默忽略 list_display 设置（尤其在字段不存在时引发 ImproperlyConfigured 异常，但部分版本可能仅表现为字段空白）。
✅ 正确流程如下：
-
生成迁移文件（基于模型差异）：
python manage.py makemigrations
✅ 提示：若首次为该 App 创建模型，Django 会生成如 0001_initial.py 的迁移文件；若已有迁移但模型变更（如新增字段），则生成增量迁移。
-
将迁移应用到数据库：
Django Unfold下载提供使用 django-unfold (v0.56+) 构建高级 Django 管理界面的专业指导。当用户提及 django-unfold、unfold admin 等内容时使用此技能。
python manage.py migrate
✅ 此步骤真正修改数据库表结构（如创建 attendance 表、添加 user_id, course_id, date, status 等列）。
重启开发服务器（必要时）：
若 Admin 页面已打开，建议重启 python manage.py runserver，确保 Django 重新加载模型元数据。
? 额外验证建议：
- 运行 python manage.py showmigrations 查看 Attendance 所属 App 的迁移是否已标记为 ✅；
- 检查数据库（如 SQLite/PostgreSQL）中是否存在 your_app_name_attendance 表及对应字段；
- 确保 admin.py 中无语法错误，且 AttendanceAdmin 类确实被 admin.site.register() 调用（你的代码已正确实现）；
- 若仍不显示，请检查浏览器控制台或 Django 日志是否有 FieldError 或 KeyError，例如 status 字段名拼写错误或类型不兼容（但本例中无此问题）。
? 小贴士：
- makemigrations 是“生成蓝图”，migrate 是“施工落地”——二者缺一不可；
- 生产环境务必先备份数据库再执行 migrate；
- 使用 --dry-run 参数可预览迁移 SQL（如 python manage.py sqlmigrate your_app 0001）。
完成上述步骤后，访问 /admin/your_app/attendance/，即可看到 user、course、date 和 status 四列清晰展示，且支持排序与搜索（需额外配置 search_fields 或 list_filter）。这是 Django ORM 与 Admin 协同工作的基础闭环，也是每个 Django 开发者必须掌握的核心工作流。
