在Django中配置静态文件与模板后启动服务器报错，求解决方案

一、先检查Static文件核心配置 #

不管Debug是True还是False，静态文件配置错误是这类问题的高发原因：

• 打开settings.py，确认以下参数配置正确：

  STATIC_URL = '/static/'
  # 指向你手动创建的static文件夹
  STATICFILES_DIRS = [
      BASE_DIR / "static",
  ]
  # Debug=False时必须用到的静态文件收集目录
  STATIC_ROOT = BASE_DIR / 'staticfiles'
  

• 如果你把Bootstrap的css、js文件放在static/bootstrap这类子文件夹中，模板里的路径要对应，别出现拼写错误。
• Debug=False时，必须执行 python manage.py collectstatic，把所有静态文件同步到STATIC_ROOT指定的目录，否则Django无法加载静态资源。

二、Templates文件夹配置要到位 #

• 确认settings.py的TEMPLATES配置里包含你的templates目录：

  TEMPLATES = [
      {
          'BACKEND': 'django.template.backends.django.DjangoTemplates',
          'DIRS': [BASE_DIR / 'templates'],  # 准确指向你创建的templates文件夹
          'APP_DIRS': True,
          # 其他默认配置保持不变
      },
  ]
  

• 模板里引入Bootstrap必须用{% static %}标签，且开头要加载static标签：

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

  不要直接写硬编码路径，用模板标签才是Django的标准用法。

三、Debug=False时的额外注意事项 #

Debug切换为False后，Django会严格检查配置，这几个点别遗漏：

• 必须配置ALLOWED_HOSTS，比如：

  ALLOWED_HOSTS = ['localhost', '127.0.0.1']
  

  否则直接触发400错误。
• Django默认不处理静态文件，推荐用whitenoise解决：
  1. 先安装依赖：pip install whitenoise
  2. 在settings.py的MIDDLEWARE中添加一行（放在SecurityMiddleware后面）：

     MIDDLEWARE = [
         'django.middleware.security.SecurityMiddleware',
         'whitenoise.middleware.WhiteNoiseMiddleware',
         # 其他中间件保持不变
     ]
     

  3. 开启静态文件压缩缓存：

     STATICFILES_STORAGE = 'whitenoise.storage.CompressedManifestStaticFilesStorage'
     

四、最后排查细节 #

• 查看服务器启动时的控制台报错，比如提示“找不到xxx.css”，就去检查文件路径是否拼写错误（Linux/macOS环境下路径大小写敏感）。
• 确认Bootstrap文件是完整下载的，不要只下载了部分内容就放到static文件夹，可打开css/js文件查看内容是否正常。

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