直接写 href="stylepage.css" 会失效，因为Django不响应相对路径请求；CSS必须放在STATICFILES_DIRS指定的静态目录中，并用{% load static %}和{% static 'stylepage.css' %}生成可访问URL。
为什么直接写 href="stylepage.css" 会失效
浏览器请求的是 HTTP URL，而 stylepage.css 这种相对路径会被解析为相对于当前页面 URL（比如 / 或 /about/），最终尝试请求 /stylepage.css —— 但 Django 默认根本不会响应这个路径。模板里的 templates/ 目录只用于服务端渲染，不对外提供 HTTP 访问；CSS 文件必须放在 Django 明确“托管”的静态目录下，并通过 {% static %} 翻译成真实可访问的 URL。
{% load static %} 必须出现在模板顶部，且不能省略
这是硬性规则：Django 模板引擎默认不认识 {% static %}，不 {% load static %} 就会报错 Invalid block tag on line X: 'static'. Did you forget to register or load this tag?。它不是全局内置标签，必须显式加载。
- 必须写在模板最上方（
{% load static %}可以在之前，但不能在{% if %}或{% for %}块内部） - 一行只能加载一个标签库，不能写成
{% load static url %}（虽然有些旧教程这么写，但 Django ≥ 4.0 已不支持逗号分隔） - 如果用了多个应用的静态文件，不需要重复
{% load static %}，一次就够了
settings.py 中 STATICFILES_DIRS 指向的路径必须存在且可读
Django 开发时靠 STATICFILES_DIRS 列表去磁盘上找 CSS 文件。如果路径写错、拼写大小写不符（尤其在 Linux/macOS）、或目录根本没创建，{% static 'stylepage.css' %} 会生成 URL（如 /static/stylepage.css），但请求返回 404。
提供使用 django-unfold (v0.56+) 构建高级 Django 管理界面的专业指导。当用户提及 django-unfold、unfold admin 等内容时使用此技能。
- 推荐用
BASE_DIR / "static"（Python 3.4+ 的pathlib写法），比os.path.join(BASE_DIR, 'static')更安全，自动处理路径分隔符 - 确认该路径下确实有
stylepage.css，而不是在templates/static/或myapp/static/里——除非你明确把那个路径加进了STATICFILES_DIRS -
STATIC_ROOT在开发阶段可以完全不设；设了反而容易误配成document_root=settings.STATIC_ROOT，导致静态文件 404（因为此时 Django 去空目录找）
urls.py 中的 static() 路由仅对 DEBUG=True 有效，且 document_root 要配对
开发服务器（runserver）本身不提供静态文件服务，全靠你在 urls.py 末尾手动追加的 static() 路由来“打补丁”。但它有两个关键约束：
立即学习“前端免费学习笔记（深入）”；
- 必须用
if settings.DEBUG:包裹，否则生产环境会暴露敏感路径 -
document_root参数必须指向实际存放 CSS 的目录，通常是STATICFILES_DIRS[0]，而不是STATIC_ROOT（后者是collectstatic的输出目录，开发时为空） - 常见错误写法：
static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)→ 开发时必 404 - 正确写法：
static(settings.STATIC_URL, document_root=BASE_DIR / "static")（与STATICFILES_DIRS一致）
最容易被忽略的一点：Django 不会报错告诉你静态文件没找到——它只会默默返回 404，而浏览器控制台里看到的只是 “Failed to load resource”，样式不生效却找不到原因。务必打开开发者工具的 Network 标签页，过滤 css，看那个 /static/xxx.css 请求是不是 404，再逆向检查路径和配置是否真正对得上。
