django 默认不自动启用静态文件服务，必须确保 debug=true、installed_apps 包含 'django.contrib.staticfiles'，且正确配置 static_url 和 staticfiles_dirs；开发时 static_root 可忽略，模板中须用 {% load static %} 和 {% static 'path' %} 引用。
确认 Django 的静态文件配置是否启用
默认情况下，Django 会自动处理 STATIC_URL 和 STATICFILES_DIRS，但必须确保 DEBUG = True 且已启用 django.contrib.staticfiles。如果页面加载 CSS 后无效果，第一反应不是路径写错，而是检查这个基础配置是否生效。
-
INSTALLED_APPS中必须包含'django.contrib.staticfiles' -
STATIC_URL = '/static/'（推荐保持默认） - 开发时无需手动配置
STATIC_ROOT；部署才需collectstatic - 若修改过
STATIC_URL（如设为'/assets/'），所有模板中的引用也得同步改
在模板中正确使用 {% static %} 模板标签
直接写 <link href="/static/css/style.css"> 看似简单，但绕过了 Django 的静态文件查找机制，会导致开发环境正常、生产环境 404。必须用 {% static %} 标签生成真实路径。
- 先在模板顶部加载标签：
{% load static %} - 引用方式：
<link rel="stylesheet" href="%7B%%20static%20'css/style.css'%20%%7D"> - 路径是相对于
STATICFILES_DIRS或应用内static/目录的相对路径，不是文件系统绝对路径 - 不要写成
{% static '/css/style.css' %}（开头斜杠会破坏查找逻辑）
静态文件该放在哪：项目级 vs 应用级目录
Django 推荐按功能拆分静态资源——通用样式放项目级，应用专属样式放应用自己的 static/ 子目录。两者都会被 staticfiles 自动收集，但优先级不同。
- 项目级：在
settings.py同级建static/，然后加入STATICFILES_DIRS = [BASE_DIR / 'static'] - 应用级：在某个 app 目录下建
static/myapp/，放myapp/style.css，模板中引用为{% static 'myapp/style.css' %} - 同名文件存在时，应用级目录优先于项目级（按
STATICFILES_DIRS列表顺序和 INSTALLED_APPS 顺序共同决定） - 避免把所有 CSS 堆进一个
static/css/，后期维护和复用成本高
常见 404 场景和调试方法
浏览器开发者工具 Network 面板看到 CSS 请求返回 404，别急着改路径，先确认请求地址是否被 Django 路由拦截——这是最常被忽略的点。
- 检查请求 URL 是否以
STATIC_URL开头（如/static/css/style.css），如果不是，说明模板里没用{% static %} - 确认 URL 是否被自定义 URLconf 拦截，比如写了
path('static/', ...)这类冲突路由 - 运行
python manage.py findstatic css/style.css，看 Django 能否定位到文件（开发时有效） - 如果用 Nginx/Gunicorn 部署后 404，问题大概率出在 Web 服务器未配置静态文件服务，跟 Django 本身无关
路径拼写、大小写、引号类型（单双引号在模板中均可）、以及 static/ 目录是否真的在 Python 路径可访问范围内——这些细节在不同操作系统和部署环境下表现不一，最容易漏查。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
