Django站点中CSS引用背景图片路径无效该如何解决？

第一步：确认静态文件基础配置 #

• 检查项目settings.py中是否配置了正确的静态文件参数：

# 确保存在以下基础配置
STATIC_URL = '/static/'
# 开发环境下可额外配置静态文件查找目录，让Django能定位到static文件夹
STATICFILES_DIRS = [BASE_DIR / "static"]

• 开发环境测试时，需要在项目根urls.py中添加静态文件服务路由：

from django.conf import settings
from django.conf.urls.static import static

urlpatterns = [
    # 你的其他现有路由
] + static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)

第二步：修改模板内的CSS代码 #

你是直接在Django模板（HTML文件）中编写的CSS，直接写相对路径无法匹配Django的静态文件解析规则，需要使用Django内置的static模板标签：

1. 首先在你的my.html文件最顶部添加静态标签加载声明：

{% load static %}

2. 修改CSS代码中背景图的路径配置：

.bgimg {
  background-image: url('{% static 'images/1.jpg' %}');
  height: 100%;
  background-position: center;
}

额外说明 #

如果你后续把CSS抽成独立的静态文件，无法在CSS文件中使用模板标签的话，可以直接写基于站点根目录的绝对路径：

background-image: url('/static/images/1.jpg');

生产环境部署前需要执行python manage.py collectstatic命令，收集所有静态文件到统一的托管目录。

内容的提问来源于stack exchange，提问作者project.py