根本原因是Django的STATIC_URL与STATICFILES_DIRS配置不匹配或开发服务器未启用静态文件服务；DEBUG=True且INSTALLED_APPS含'django.contrib.staticfiles'时，runserver才响应/static/请求。
为什么 {% static %} 在 CSS 引入时经常 404？
根本原因不是路径写错了，而是 Django 的 STATIC_URL 和 STATICFILES_DIRS 配置不匹配，或者开发服务器没启用静态文件服务。模板里写 {% static 'css/base.css' %} 后渲染成 /static/css/base.css，但浏览器发请求时，Django 只有在 DEBUG=True 且配置了 django.contrib.staticfiles 的前提下，才通过 runserver 自动响应这个 URL。
- 检查
settings.py是否包含'django.contrib.staticfiles'在INSTALLED_APPS中 - 确认
STATIC_URL = '/static/'（末尾斜杠不能少） -
STATICFILES_DIRS必须是绝对路径，推荐用BASE_DIR / 'static'写法，别用相对路径或字符串拼接 - 确保你的 CSS 文件真正在
STATICFILES_DIRS指向的目录下，比如static/css/theme-dark.css
如何根据上下文动态切换 CSS 文件？
模板里不能执行 Python 表达式，所以不能直接写 {% static user.theme + '.css' %}。必须靠视图传入完整路径，或用模板逻辑预拼接。
- 视图中提前构造好路径：
context['css_url'] = static('css/' + user_preferred_theme + '.css')，模板里直接用{{ css_url }} - 如果主题名来自 request 或 session，建议统一在中间件或 context processor 中注入，避免每个视图重复处理
- 不推荐在模板里用
{% with %}拼接再传给{% static %}——{% static %}不接受变量作为参数，只接受字面量字符串 - 若需多套主题，可把 CSS 文件名列表传入模板，用
{% for theme in themes %}循环生成<link>标签，每条都用独立的{% static %}
使用 {% static %} 加载 CSS 时的常见错误写法
这些写法看似合理，实际会失效或引发隐患：
- 写成
<link href="{% static 'css/base.css' %}" rel="stylesheet">—— 缺少</>或</link>，HTML5 虽宽松，但某些前端构建工具或校验器会报错 - 路径开头加
/，如{% static '/css/base.css' %}——{% static %}会把它当成绝对路径，忽略STATIC_URL前缀，结果变成/css/base.css而非/static/css/base.css - 在
base.html里用{% static %}引入，但子模板覆盖<head>时没保留原标签，导致样式丢失 - 生产环境忘记运行
python manage.py collectstatic，而 Nginx/Apache 又没配置静态文件路由，所有{% static %}渲染出的路径都 404
是否必须用 {% static %}？有没有更轻量的替代？
在纯开发阶段、且确定不会换域名或 CDN 时，可以硬编码 /static/css/app.css，省去模板标签开销。但一旦涉及部署策略变化（比如静态资源上 CDN），就必须回归 {% static %} —— 它的真正价值是解耦路径配置与模板内容。
立即学习“前端免费学习笔记（深入）”；
-
{% static %}本质是调用django.contrib.staticfiles.storage.staticfiles_storage.url()，你可以重写这个 storage 类来支持版本哈希、CDN 域名等高级行为 - 如果项目用 Webpack/Vite 管理前端资源，通常会禁用 Django 的 staticfiles，改用
whitenoise或直接由反向代理服务静态文件，此时{% static %}仍可用，但底层逻辑已不同 - 注意：
{% load static %}必须出现在模板顶部，且不能放在{% block %}内部 —— 否则子模板继承时可能未加载就调用，报Invalid block tag
{% static %} 看似简单，但它的行为高度依赖配置和部署方式。最容易被忽略的是：它在开发和生产中走的是两套完全不同的文件查找逻辑 —— 开发靠 runserver 动态查找，生产靠 collectstatic 预复制。路径对了，不代表文件真能被找到。 
