求助：Django Admin页面样式原始，与预期显示不符

问题描述 #

学习Django Admin时，本地通过虚拟环境运行的Admin页面样式原始，与教程预期样式不一致，已在Reddit、Discord社区求助未得到有效解决。

排查及解决步骤 #

• 验证django.contrib.staticfiles是否启用
  打开项目settings.py文件，检查INSTALLED_APPS中是否包含django.contrib.staticfiles，若缺失则添加：

  INSTALLED_APPS = [
      'django.contrib.admin',
      'django.contrib.auth',
      'django.contrib.contenttypes',
      'django.contrib.sessions',
      'django.contrib.messages',
      'django.contrib.staticfiles',  # 必须存在这一项
      # 自定义应用
  ]
  

• 确认STATIC_URL配置正确
  在settings.py中确保STATIC_URL设置为：

  STATIC_URL = '/static/'
  

• 收集静态文件
  激活虚拟环境后，在终端执行以下命令：

  python manage.py collectstatic
  

  出现覆盖提示时输入yes完成操作。

• 配置开发环境静态文件路由
  在项目根目录的urls.py中添加静态文件路由（仅用于开发阶段）：

  from django.conf import settings
  from django.conf.urls.static import static
  from django.contrib import admin
  
  urlpatterns = [
      path('admin/', admin.site.urls),
      # 其他业务路由
  ] + static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)
  

• 强制刷新浏览器缓存
  按Ctrl+Shift+R（Windows/Linux）或Cmd+Shift+R（Mac）强制刷新页面，避免缓存导致样式不加载。

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