必须加载 {% 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="%7B%%20static%20'css/style.css'%20%%7D">
- 确保
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 顺序取第一个匹配的——顺序错了，引入的可能是旧版本。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
