Django 4.1无法识别静态CSS文件，寻求解决方案

我是Django新手，正在开发一个需要较多样式的小项目，但Django无法识别我的静态CSS文件。我已经检查过拼写、settings.py路径，也查阅了大量技术帖子，仍未找到解决办法。以下是我的相关代码：

settings.py #

from pathlib import Path

TEMPLATES_DIR = Path(BASE_DIR) / 'templates'
STATIC_DIR = Path(BASE_DIR) / 'static'

DEBUG = True
ALLOWED_HOSTS = []

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'CalculatorApp'
]

MIDDLEWARE = [
    'django.middleware.security.SecurityMiddleware',
    'django.contrib.sessions.middleware.SessionMiddleware',
    'django.middleware.common.CommonMiddleware',
    'django.middleware.csrf.CsrfViewMiddleware',
    'django.contrib.auth.middleware.AuthenticationMiddleware',
    'django.contrib.messages.middleware.MessageMiddleware',
    'django.middleware.clickjacking.XFrameOptionsMiddleware',
]

ROOT_URLCONF = 'Calculator.urls'

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [TEMPLATES_DIR,],
        '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',
            ],
        },
    },
]

WSGI_APPLICATION = 'Calculator.wsgi.application'

...

STATIC_ROOT = Path(BASE_DIR) / 'static'
STATIC_URL = 'static/'
STATICFILE_DIRS = [
    STATIC_DIR,
]

urls.py #

from django.contrib import admin
from django.urls import path
from CalculatorApp import views
urlpatterns = [
    path('', views.index, name='index'),
    path('admin/', admin.site.urls),
]

views.py #

from django.shortcuts import render
# Create your views here.
def index(request):
    return render(request, 'index.html')

关键解决建议 #

• 修正配置项拼写错误：你当前写的STATICFILE_DIRS是错误的，正确配置项为STATICFILES_DIRS（末尾多一个S），这是Django识别额外静态文件目录的核心配置，拼写错误会直接导致目录无法被识别。
• 分离STATIC_ROOT与静态文件目录：STATIC_ROOT是部署时collectstatic命令收集所有静态文件的目标目录，在开发模式下不要和你存放静态文件的static目录重合。建议修改配置：

  STATIC_ROOT = Path(BASE_DIR) / 'staticfiles'
  

• 模板中正确引用静态文件：在index.html顶部必须添加静态文件加载标签，然后用模板标签引用CSS文件：

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

  （假设你的CSS文件路径为static/css/style.css，根据实际目录结构调整）
• 确认静态文件目录结构：确保你的CSS文件放在项目根目录的static文件夹下，比如static/css/xxx.css，而非App目录内的static文件夹（若用App内静态文件，需保证APP_DIRS=True且文件放在CalculatorApp/static/CalculatorApp/下）。
• 重启开发服务器：修改settings.py配置后，必须重启Django开发服务器，新配置才会生效。

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