Django项目中CSS文件修改后未更新问题求助

这种情况我开发Django项目时也碰到过好几次，大概率是浏览器缓存或者Django静态文件处理的缓存机制在搞鬼，给你几个一步步排查解决的方法：

• 强制刷新浏览器缓存
  浏览器为了提升加载速度，会自动缓存静态资源。哪怕你已经修改了服务器上的CSS文件，它还是会优先读取本地缓存的旧版本。试试快捷键强制刷新：Windows/Linux按Ctrl+F5，Mac按Cmd+Shift+R，这会让浏览器忽略本地缓存，重新请求所有资源。

• 检查静态文件的存放路径与引用逻辑
  你提到把新背景图放到了media文件夹，但这里有个容易踩的坑：

  • Django的media目录是用来存储用户上传的动态文件的，而网站的固定静态资源（比如CSS、背景图）应该放在static目录下，比如static/images/ak.jpg
  • 再核对CSS里的路径：如果你的CSS文件在static/css/style.css，那么url("images/ak.jpg")对应的实际路径是static/css/images/ak.jpg，如果你的图片在static/images目录，那应该改成url("../images/ak.jpg")；更稳妥的方式是在模板里用Django的static标签来引用CSS，确保路径绝对正确：

    <link rel="stylesheet" href="{% static 'css/style.css' %}">
    

• 确认Django静态文件服务的配置
  如果是开发环境（DEBUG=True），检查settings.py里的静态文件配置是否正确：

  STATIC_URL = '/static/'
  STATICFILES_DIRS = [
      BASE_DIR / "static",
  ]
  

  另外，如果你之前运行过python manage.py collectstatic，开发服务器可能会读取收集后的静态文件副本，这时候可以删除项目根目录下的staticfiles文件夹，让开发服务器重新加载原始的静态文件。

• 配置静态文件哈希，彻底解决缓存问题
  要是想从根源上避免这类缓存问题（尤其是部署到生产环境后），可以开启Django的静态文件版本哈希功能：
  在settings.py中添加：

  STATICFILES_STORAGE = 'django.contrib.staticfiles.storage.ManifestStaticFilesStorage'
  

  之后每次修改静态文件后，运行python manage.py collectstatic，Django会给每个静态文件生成唯一的哈希后缀（比如style.abc123.css）。因为文件名变了，浏览器会自动识别为新资源，不会再读取旧缓存。不过开发环境下每次修改都要跑命令，有点繁琐，建议只在生产环境开启这个配置。

内容的提问来源于stack exchange，提问作者Akhil Reddy