Django模板中CSS不生效主因是未用{% static %}机制或STATICFILES_DIRS配置错误；浏览器请求URL而非文件路径，硬编码href="style.css"导致404；必须加载{% load static %}且路径需匹配STATICFILES_DIRS或app内static/子目录结构。
CSS 文件在 Django 模板中不生效，基本是因为路径没走 {% static %} 机制，或者 STATICFILES_DIRS 指向了错误位置。
为什么直接写 href="style.css" 会 404
Django 的模板目录（templates/）和静态资源目录（static/）物理隔离：浏览器请求的是 URL，不是文件系统路径。硬编码 href="style.css" 会让浏览器去当前页面同级 URL 下找，比如 /polls/style.css，而 Django 根本没配置这个路由。
- 开发时，Django 只通过
STATIC_URL（默认/static/）前缀提供静态文件服务 -
runserver不会自动映射模板目录下的任何子路径为静态资源 - 即使你把
style.css放进templates/里，它也不会被staticfiles扫描到
{% load static %} 和 {% static 'xxx' %} 必须成对出现
模板顶部漏掉 {% load static %} 是最常见低级错误——此时 {% static %} 标签根本无法解析，浏览器收到的还是原始模板文本，比如 href="{% static 'css/style.css' %}"，显然不是合法 URL。
- 必须放在
{% load %}块内，且只能在模板开头附近（不能在{% block %}内部再 load） -
{% static %}的参数是相对于STATICFILES_DIRS或各 app 的static/子目录的路径，不是完整文件系统路径 - 例如 CSS 放在
myapp/static/myapp/style.css，就该写{% static 'myapp/style.css' %}，不是'style.css'
STATICFILES_DIRS 和 app 内 static/ 目录怎么选
项目级静态资源（如全局 base.css、第三方库 JS）走 STATICFILES_DIRS；按应用组织的样式（如 polls/style.css）必须放进对应 app 的 static/polls/ 子目录。
提供使用 django-unfold (v0.56+) 构建高级 Django 管理界面的专业指导。当用户提及 django-unfold、unfold admin 等内容时使用此技能。
- 若多个 app 都有
style.css，不加命名空间会导致 Django 随机加载第一个匹配项——所以polls/static/polls/style.css是规范写法 -
STATICFILES_DIRS = [BASE_DIR / "static"]中的"static"是项目根目录下的文件夹，不是 app 内的static/ - 确保
INSTALLED_APPS包含django.contrib.staticfiles，否则{% static %}标签不可用
开发时 CSS 改了但浏览器没更新？检查缓存与 URL
开发阶段 runserver 默认启用静态文件服务，但浏览器可能缓存旧 CSS，或你误用了 STATIC_URL = "static/"（少斜杠）导致生成 URL 错误。
- 打开浏览器开发者工具 Network 标签页，看 CSS 请求是否返回 200，URL 是否形如
/static/css/style.css - 确认
settings.py中STATIC_URL以/开头，如STATIC_URL = '/static/' - 强制刷新（Ctrl+Shift+R）或禁用缓存（Network 面板勾选 Disable cache）排除前端干扰
真正容易被忽略的是：命名空间不是可选项，而是冲突预防的强制设计；还有，DEBUG=False 时 runserver 不再提供静态文件服务——哪怕配置全对，也会立刻 404。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
