css加载失败90%是url路径与服务器物理路径不匹配所致，而非css语法错误；常见于django中static_url与static_root混用、spring boot静态资源映射被覆盖、css内相对路径解析错乱，以及debug=false或打包排除导致的静默失效。
直接说结论：CSS 文件加载失败，90% 是因为 URL 路径（浏览器看到的）和服务器实际文件位置（物理路径）没对上，而不是 CSS 本身写错了。
Django 中 STATIC_URL 和 STATIC_ROOT 混用导致 404
开发时设了 STATIC_URL = '/static/'，但忘了配 STATICFILES_DIRS 或误把 STATIC_ROOT 当成源目录用，结果浏览器请求 /static/css/base.css 时返回 404。
-
STATICFILES_DIRS是你放原始 CSS/JS 的地方（如BASE_DIR / 'static'），开发服务器靠它找文件 -
STATIC_ROOT是部署时python manage.py collectstatic把所有静态文件“打包”到的目标目录，开发阶段不用管它 - 如果在
settings.py里写了STATIC_ROOT却没运行collectstatic，Django 开发服务器不会自动去那里找文件 - 检查是否漏加
django.contrib.staticfiles到INSTALLED_APPS—— 没它，STATICFILES_DIRS就不生效
Spring Boot 的 /static 映射被自定义配置覆盖
项目里加了 WebMvcConfigurer 或写了 @Configuration 类手动注册 addResourceHandlers，但没调用 super.addResourceHandlers(registry)，导致默认的 /static、/public 映射被清空。
Django Unfold
下载
提供使用 django-unfold (v0.56+) 构建高级 Django 管理界面的专业指导。当用户提及 django-unfold、unfold admin 等内容时使用此技能。
- Spring Boot 默认映射的路径是：
classpath:/static、classpath:/public、classpath:/resources、classpath:/META-INF/resources - 只要你在配置类里重写了
addResourceHandlers，就必须显式补全这些路径，或者保留父类逻辑 - 常见错误写法：
registry.addResourceHandler("/css/**").addResourceLocations("file:/opt/myapp/css/")—— 这会覆盖掉所有默认映射，连/static/js/app.js都 404 - 正确做法：要么只扩展现有配置（用
if (!this.resourceProperties.isAddMappings())判断），要么手动补全全部默认路径
CSS 里引用图片用相对路径还是绝对 URL？
在 style.css 里写 background: url(../img/logo.png) 很容易出错，尤其当 CSS 被多个 URL 路径引用时（比如 /admin/css/base.css 和 /static/css/base.css）。
- 浏览器解析 CSS 中的
url()是相对于该 CSS 文件**自身 URL 的路径**，不是 HTML 页面路径，也不是项目根路径 - 推荐统一用以
STATIC_URL（Django）或/static/（Spring Boot）开头的绝对路径：background: url(/static/img/logo.png) - Django 模板中可借助
{% static %}标签生成路径，但纯 CSS 文件里做不到 —— 所以 CSS 内部尽量避免依赖动态路径，图片资源统一放在STATIC_URL下固定子路径 - Spring Boot 若用了外部磁盘目录映射（如
file:/data/uploads/），CSS 里不能写url(/uploads/xxx.png)，除非你同时配置了addResourceHandler("/uploads/**")映射到那个目录
最常被忽略的一点：Django 的 DEBUG=False 时，django.contrib.staticfiles 完全不工作；Spring Boot 打成 jar 包后，classpath:/static 里的 CSS 如果被 Maven 打包排除了，也会静默失效 —— 这些都不是路径写错了，而是构建或部署环节断掉了映射链条。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
