Django模板如何引入静态CSS文件-css教程-PHP中文网

根本原因是static_url与staticfiles_dirs配置不匹配或开发服务器未启用静态文件服务；debug=true且installed_apps含'django.contrib.staticfiles'时，runserver才响应/static/请求。

django模板如何引入静态css文件

直接结论：必须用 {% static %} 标签，且 STATIC_URL 和 STATICFILES_DIRS 配置不匹配是 404 的主因，不是路径写错。

Django 开发服务器只在 DEBUG=True 且 'django.contrib.staticfiles' 在 INSTALLED_APPS 中时，才响应 /static/... 请求。常见错误包括：

STATIC_URL 写成 '/static/'（开头带斜杠）→ 渲染出 //static/css/base.css，浏览器拒绝请求
STATICFILES_DIRS 用了相对路径或字符串拼接，比如 os.path.join('static') → Django 找不到真实目录
实际 CSS 文件没放在 STATICFILES_DIRS 指向的目录下（例如你配了 BASE_DIR / 'static'，但文件却在 myapp/static/css/ 里）
DEBUG=False 时，runserver 默认不提供静态文件服务（生产环境应由 Nginx 处理）

三件事缺一不可：

Django Unfold

提供使用 django-unfold (v0.56+) 构建高级 Django 管理界面的专业指导。当用户提及 django-unfold、unfold admin 等内容时使用此技能。

下载

模板顶部必须有 {% load static %}（不能省，也不能写在之后）
href 值必须是 {% static 'css/base.css' %} 这种形式——路径是相对于 STATICFILES_DIRS 下某个目录的子路径，**不加开头斜杠**
不要手写 /static/css/base.css：它绕过 Django 静态文件机制，一旦你改了 STATIC_URL 就全挂

示例正确写法：

{% load static %}
<link rel="stylesheet" href="%7B%%20static%20'css/base.css'%20%%7D">

{% static %} 只接受字面量字符串，不支持变量拼接，所以 {% static user.theme|add:'.css' %} 会报错或静默失败。

视图中提前构造好 URL：context['theme_css'] = static(f'css/{user_preferred_theme}.css')，模板里直接 {{ theme_css }}
若主题来自 session 或 request，建议统一在 context processor 或中间件里注入，避免每个视图重复处理
多个主题可传列表：context['themes'] = ['light', 'dark', 'blue']，模板中用 {% for t in themes %}<link href="%7B%%20static%20'css/'%7Cadd:t%7Cadd:'.css'%20%%7D">{% endfor %} —— 注意：这里 add 是过滤器，{% static %} 仍只接收字面量，所以仍需确保每个 'css/light.css' 等路径真实存在

路径分隔符和 BASE_DIR 写法决定成败。用 pathlib.Path 是最稳的：

STATICFILES_DIRS = [BASE_DIR / 'static'] ✅（自动处理 / 或 \）
STATICFILES_DIRS = [os.path.join(BASE_DIR, 'static')] ❌（Windows 下可能出 \，引发路径解析失败）
STATIC_URL = 'static/' ✅（结尾斜杠可选，但开头绝对不能有斜杠）
确认 static/css/base.css 文件真实存在于磁盘上，而不是只在 IDE 里“看起来有”