为什么我的Django项目中HTML模板无法加载Bootstrap CSS样式？

错误点及对应修复方案 #

• 错误点1：settings.py静态文件配置缺失/错误
  修复方案：
  打开项目settings.py文件，确认以下配置项完整正确：

  # 基础静态路径前缀配置
  STATIC_URL = 'static/'
  # 配置静态文件读取目录，指向你存放Bootstrap文件的static根目录
  STATICFILES_DIRS = [
      BASE_DIR / "static",
  ]
  # 生产环境静态文件收集目录可提前配置
  STATIC_ROOT = BASE_DIR / "staticfiles"
  

• 错误点2：根路由未配置静态资源访问规则
  修复方案：
  打开项目根目录urls.py，补充静态资源路由映射：

  from django.conf import settings
  from django.conf.urls.static import static
  
  urlpatterns = [
      # 此处保留你原有配置的路由规则
  ] + static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)
  

• 错误点3：HTML模板静态文件引用方式不符合Django规范
  修复方案：
  HTML模板首行必须加载静态资源模板标签，引用Bootstrap文件使用Django内置语法：

  {% load static %}
  <link rel="stylesheet" href="{% static 'css/bootstrap.min.css' %}">
  <script src="{% static 'js/bootstrap.bundle.min.js' %}"></script>
  

• 错误点4：静态目录权限不足（仅Linux/Mac环境可能出现）
  修复方案：
  给static目录授予可读权限，执行命令：

  chmod -R 755 你的项目完整路径/static
  

修改完成后重启Django开发服务，刷新页面即可验证修复效果。

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