必须加载 {% load static %} 才能用 {% static %}，否则模板直接报错或路径拼错；最常见原因是漏掉该加载声明，导致标签未识别而原样输出，引发 404。

必须加载 {% load static %} 才能用 {% static %}，否则模板直接报错或路径拼错

为什么 {% static %} 不生效？

最常见原因是漏掉加载标签库。Django 模板默认不识别 static 标签，必须显式声明。没这句，{% static 'css/style.css' %} 会被原样输出成字符串，浏览器请求的是字面量路径，比如 /static/css/style.css/（注意末尾斜杠），404 是必然的。

• 每个要用 static 的模板顶部第一行（或至少在首次使用前）加 {% load static %}
• 不能写成 {% load staticfiles %}（旧版 Django 1.8 以前用，已废弃）
• 如果用了 django.contrib.staticfiles 但没在 INSTALLED_APPS 里注册，load static 会静默失败——检查 settings.py

{% static %} 输出的路径到底长什么样？

它不是简单拼接 STATIC_URL 和参数，而是经过解析和安全校验的。例如：{% static 'css/style.css' %} 在开发时可能输出 /static/css/style.css，上线后若配置了 CDN，可能变成 https://cdn.example.com/static/css/style.css。关键点：

Django Unfold

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

下载

• 参数路径不能以 / 开头，否则会被截断（{% static '/css/style.css' %} → 实际请求 /static/css/style.css，但 Django 内部处理时会去掉开头斜杠，结果可能意外）
• 路径是相对于 STATIC_ROOT 或各 STATICFILES_DIRS 下的子目录，不是相对于模板文件位置
• 不会自动添加版本号或哈希值，如需缓存 busting，得配合 ManifestStaticFilesStorage 和 collectstatic

在 <link> 中正确引入 CSS 的写法

别用硬编码路径，也别把 {% static %} 套在引号里（比如 href="{% static 'css/style.css' %}" 是对的，href="{% static 'css/style.css' %}/" 就多了一个斜杠）。

立即学习“前端免费学习笔记（深入）”；

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

• 确保 css/style.css 真实存在于某个 static 目录下（如 myapp/static/css/style.css 或项目根目录 static/css/style.css）
• 开发时运行 python manage.py runserver 即可自动服务静态文件；生产环境必须用 Web 服务器（Nginx/Apache）或 whitenoise 提供 STATIC_ROOT 路径下的文件
• 如果 CSS 里有 @import 或背景图路径，那些是 CSS 解析的相对路径，跟 Django 模板无关，要按 CSS 文件所在位置去算

最容易被忽略的是：当多个应用都有同名静态文件（比如都叫 css/base.css），Django 会按 INSTALLED_APPS 顺序取第一个匹配的——顺序错了，引入的可能是旧版本。