如何在Django项目中使用Bootstrap样式？静态文件404求助

Hey Olivia, let's walk through this step by step—missing static files are one of the most common gotchas in Django, so we'll track down the issue quickly.

1. Double-Check Your Django Static Settings #

First, make sure your settings.py has the correct configuration for static files. Here's what you need:

• STATIC_URL: This should map to your static root. It's usually set to:

  STATIC_URL = '/static/'
  

• STATICFILES_DIRS: This tells Django where to look for project-level static files (not tied to a specific app). If your static folder lives in the project root (same directory as manage.py), add this:

  STATICFILES_DIRS = [
      BASE_DIR / "static",
  ]
  

  Note: For Django versions before 3.1, use os.path.join(BASE_DIR, "static") instead of the pathlib syntax.

2. Verify Your File Paths Are Exact #

Typos and folder structure mix-ups are easy to make:

• Confirm your static folder is in the project root (not nested inside an app folder, unless you intentionally set that up).
• Check that the file exists exactly at static/css/bootstrap.min.css—no typos (like bootstap instead of bootstrap), no mismatched capitalization (Django is case-sensitive on most systems).
• Try opening the file directly in your file explorer to ensure it's not corrupted or missing entirely.

3. Use Django's Static Template Tag (Critical!) #

You can't just hardcode the /static/ path in your template—Django needs to resolve it properly using the static template tag. Fix your index.html like this:

• At the very top of your template, load the static tag library:

  {% load static %}
  

• Replace your Bootstrap link with this:

  <link rel="stylesheet" href="{% static 'css/bootstrap.min.css' %}">
  

  This ensures Django uses the correct STATIC_URL you defined, and avoids issues if you ever adjust your static file setup later.

4. Restart Your Development Server #

Django's runserver caches certain settings—if you modified settings.py or added the static folder after starting the server, you need to stop and restart it. Just hit Ctrl+C in your terminal, then run python manage.py runserver again.

5. Test With a Simple Static File #

To rule out Bootstrap-specific issues, try adding a test file (like static/img/test.png) and reference it in your template:

<img src="{% static 'img/test.png' %}" alt="Test">

If this image loads, the problem is specific to your Bootstrap file (maybe it's corrupted, or the path is wrong). If it also throws a 404, go back and double-check your settings and folder structure.

6. Check for App-Specific Static Folders (If Applicable) #

If you placed Bootstrap files inside an app's static folder (e.g., myapp/static/css/bootstrap.min.css), make sure that app is listed in INSTALLED_APPS in settings.py—Django automatically looks for static files in installed apps.

Once you work through these steps, your Bootstrap CSS should load without the 404 error. Let me know if any of these steps uncover the issue!

内容的提问来源于stack exchange，提问作者Olivia Brown