Django静态文件无法加载问题求助（附配置代码）

Hey there, let's work through your static files issue and clear up the confusion step by step!

First: The Critical Typo Breaking Your Static Files #

The biggest problem here is a misnamed setting in your settings.py: you used STATIC_FILES instead of the correct STATICFILES_DIRS. Django doesn't recognize STATIC_FILES at all—this is why it's ignoring your root-level static directory, even though your template configuration works fine.

STATICFILES_DIRS is Django's official setting for listing extra directories (outside of individual app static folders) where it should look for static files. Since you keep your static assets in the project root, this is exactly what you need to configure correctly.

Second: Misunderstanding STATIC_ROOT #

Your STATIC_ROOT configuration is technically correct, but it's meant for production environments only. This directory is where Django collects all static files from your apps and STATICFILES_DIRS when you run the collectstatic command.

In development mode (when DEBUG = True), Django doesn't use STATIC_ROOT to serve static files. By adding + static(settings.STATIC_URL, document_root=settings.STATIC_ROOT) to your urls.py, you're telling Django to look for static files in an empty directory (since you haven't run collectstatic yet)—that's another reason your assets aren't loading.

Third: Why Templates Work But Static Files Don't #

Your template configuration is spot-on: you set DIRS in the TEMPLATES setting to point directly to your root templates folder, so Django has no trouble finding those files. Static files failed because of the misnamed setting and incorrect urls.py configuration, not because of your directory structure.

Fixing Your Configuration #

Let's update your settings and URLs to get static files working:

1. Correct settings.py Static Configuration

import os
from pathlib import Path

BASE_DIR = Path(__file__).resolve().parent.parent

# Static files configuration
STATIC_URL = '/static/'
# Fix the variable name and keep your root static directory here
STATICFILES_DIRS = [
    os.path.join(BASE_DIR, "static"),
]
# STATIC_ROOT stays for production collectstatic use
STATIC_ROOT = os.path.join(os.path.dirname(BASE_DIR), "staticfiles", "static")

# Your TEMPLATES configuration is already correct—no changes needed here
TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [os.path.join(BASE_DIR, "templates")],
        'APP_DIRS': True,
        'OPTIONS': {
            'context_processors': [
                'django.template.context_processors.debug',
                'django.template.context_processors.request',
                'django.contrib.auth.context_processors.auth',
                'django.contrib.messages.context_processors.messages',
            ],
        },
    },
]

2. Simplify urls.py for Development

When DEBUG = True, Django's django.contrib.staticfiles (which is in your default INSTALLED_APPS) automatically handles serving static files. You don't need the manual static() addition:

from django.contrib import admin
from django.urls import path
from .views import home

urlpatterns = [
    path('admin/', admin.site.urls),
    path('', home, name='home')
]
# Remove the + static(...) line entirely for development

Addressing Your Other Questions #

• Directory structure choice: Keeping static and templates in the project root is totally valid—this isn't the cause of your issue. The tutorial's approach (placing them inside an app) is just another common pattern; Django supports both as long as you configure the settings correctly.
• Settings that control file lookup:
  • For static files: STATICFILES_DIRS (extra directories) and APP_DIRS = True (auto-scans app static folders)
  • For templates: TEMPLATES['DIRS'] (extra directories) and APP_DIRS = True (auto-scans app templates folders)
• Django version difference: This problem is almost certainly due to configuration errors, not version differences. The static file core settings like STATICFILES_DIRS haven't changed in recent Django versions.

Just make sure django.contrib.staticfiles is in your INSTALLED_APPS (it's included by default), and you should see your static files load correctly once you apply these fixes!

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