STATIC_URL 是浏览器请求静态资源的URL前缀（如/static/），STATIC_ROOT 是 collectstatic 命令汇总静态文件的目标物理目录，仅用于生产环境由Web服务器直接服务。
STATIC_URL 和 STATIC_ROOT 到底谁管什么
很多人配完 STATIC_URL 就以为 CSS 能加载了，结果 404。根本原因是混淆了「URL 路径」和「物理路径」：STATIC_URL 是浏览器请求时用的前缀（比如 /static/），而 STATIC_ROOT 是 python manage.py collectstatic 最终把所有静态文件塞进去的那个**真实文件夹**，它不参与开发期的实时访问。
开发时靠 django.contrib.staticfiles 自动从 STATICFILES_DIRS 和各 app 的 static/ 子目录里找文件；上线后才依赖 STATIC_ROOT + Web 服务器（Nginx/Apache）直接服务该目录。
-
STATIC_URL = '/static/'：模板里写{% static 'css/main.css' %}，最终生成/static/css/main.css -
STATICFILES_DIRS = [BASE_DIR / 'static']：告诉 Django 还要去项目根目录下的static/里找文件（非 app 自带的） -
STATIC_ROOT = BASE_DIR / 'staticfiles'：仅用于collectstatic，别把它设成和STATICFILES_DIRS同一个路径，否则清空重写会丢文件
模板里 {% static %} 不生效、路径拼错、404
常见现象是页面源码里看到 /static/css/app.css，但点开是 404。不是模板写错了，而是 Django 根本没找到那个文件 —— 它只在固定几个地方找：
- 每个已安装 app 目录下的
static/子目录（如myapp/static/myapp/css/style.css） - 所有
STATICFILES_DIRS列表里的路径（比如你放公共 JS 的project/static/） - 注意：Django **不会递归扫描子目录**，
static/下的vendor/bootstrap/没问题，但如果你把 CSS 放在static/css/，又在模板里写{% static 'app.css' %}（漏了css/），就会 404 - 调试技巧：运行
python manage.py findstatic css/main.css，看它到底从哪找到了这个文件
DEBUG=False 时静态文件全挂了
这是最典型的线上翻车现场。Django 在 DEBUG=True 时会自动启用 staticfiles 的视图来服务静态文件；但 DEBUG=False 时，它直接放弃——因为性能太差，不该由 Python 处理。
立即学习“Python免费学习笔记（深入）”；
你必须让 Nginx 或 Apache 去读 STATIC_ROOT 目录，并把 /static/ 请求映射过去。光改 DEBUG 不配 Web 服务器，就等于关掉电闸还指望灯亮。
- Nginx 示例片段：
location /static/ { alias /path/to/your/staticfiles/; } - 别漏掉结尾斜杠，
alias和root行为不同，用错会导致路径多一层 -
collectstatic必须在部署前手动跑一次，它不会自动触发
图片上传后 URL 正确但打不开
CSS/JS 是「静态资源」，走 STATIC_* 配置；但用户上传的图片属于「媒体文件」，得用另一套：MEDIA_URL 和 MEDIA_ROOT。
如果把头像上传到 media/avatar.jpg，却用 {% static 'avatar.jpg' %}，那肯定 404 —— static 标签只认 STATICFILES_DIRS 和 app 的 static/，根本不看 MEDIA_ROOT。
- 模板里应该用
{{ user.avatar.url }}（假设字段是ImageField），它自动拼MEDIA_URL - 开发时要在
urls.py里加：from django.conf import settings from django.conf.urls.static import static urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)
- 线上同样要由 Web 服务器配置
/media/路径，不能依赖 Django
STATIC 和 MEDIA 是两套独立机制，混用是硬伤，不是路径写错的问题。
