Django项目中CSS文件无法加载问题求助

1. 修正Settings.py的配置拼写错误 #

你当前的STATICFILE_DIRS存在拼写错误，正确的参数名是STATICFILES_DIRS（末尾多一个S），这是Django识别自定义静态文件目录的核心配置，修改后如下：

STATIC_URL = 'static/'
STATICFILES_DIRS = [
    os.path.join(BASE_DIR, "static")
]

STATIC_ROOT = os.path.join(BASE_DIR,'assets')

2. 模板必须加载static标签 #

在你的HTML文件最顶部，必须添加{% load static %}标签，否则Django无法解析{% static %}模板语法：

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

3. 开发环境无需执行collectstatic #

STATIC_ROOT是生产部署时用来汇总所有静态文件的目录，开发阶段用python manage.py runserver启动服务时，Django会自动从STATICFILES_DIRS指定的目录读取静态文件，不需要提前运行python manage.py collectstatic命令。

4. 检查文件路径与文件名准确性 #

确认bootstrap-grid.css确实存在于firstproject/static/css/目录下，注意在Linux/macOS系统中文件名区分大小写，避免因大小写不匹配导致加载失败。

5. 调整urls.py的静态文件配置（开发环境） #

开发环境下，runserver已经自动处理静态文件请求，你添加的static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)指向的是assets目录（仅在执行collectstatic后才有内容），如果没执行过该命令，这个目录是空的。可以暂时注释掉该行，或执行python manage.py collectstatic后再使用。

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