Django无法加载static文件夹图片 配置后仍不显示问题求助

1. 核对settings.py配置完整性 #

• 确认INSTALLED_APPS列表中已包含django.contrib.staticfiles（Django默认自带，误删会导致静态资源功能完全失效）
• 确认静态路径配置符合规则：

  STATIC_URL = '/static/'
  # 指向你项目根目录下的static文件夹
  STATICFILES_DIRS = [BASE_DIR / "static"]
  # 开发阶段不需要配置STATIC_ROOT，仅生产环境打包静态文件时使用
  

• 确认DEBUG = True，DEBUG设为False时Django默认不会托管静态资源，需要配合Nginx/Apache等反向代理服务使用。

2. 核对模板调用写法 #

• 模板文件第一行必须引入静态文件标签：{% load static %}，遗漏该标签会导致所有static路径解析失败。
• 图片调用写法需符合规范，示例：

  <!-- 假设图片存放在 static/img/logo.png 路径下 -->
  <img src="{% static 'img/logo.png' %}" alt="logo">
  

• 注意static标签内的路径不需要加前导的/static/，标签会自动拼接STATIC_URL前缀。

3. 核对路由配置 #

• 项目根目录urls.py中需要添加开发环境静态文件路由规则：

  from django.conf import settings
  from django.conf.urls.static import static
  
  urlpatterns = [
      # 你的原有路由配置
  ] + static(settings.STATIC_URL, document_root=settings.STATICFILES_DIRS[0])
  

4. 路径与文件名核对 #

• 如果你是在Windows环境开发，部署到Linux服务器时需要注意路径、文件名区分大小写，比如static/Img/Logo.png和static/img/logo.png会被识别为不同路径，需保证调用路径和实际文件路径完全一致。

5. 浏览器端验证 #

• 打开浏览器F12控制台，切换到「网络」标签，刷新页面查看图片请求的实际地址与返回状态码：
  • 如果返回404，说明路径匹配失败，对照前面步骤核对配置
  • 如果返回403，说明静态文件权限不足，修改对应文件/文件夹的访问权限即可
  • 如果直接访问拼接后的图片地址（域名+请求路径）可以打开，说明img标签属性书写错误，检查是否多写了引号、路径拼写错误等问题

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