Django中静态文件加载失败：HTML模板图片无法显示

看起来你是在Django项目里加载静态图片时踩了常见的路径配置坑，我来一步步帮你排查解决：

1. 先确认settings.py里的静态文件配置是否正确 #

首先得确保Django知道去哪里找你的静态文件：

• 检查INSTALLED_APPS里有没有django.contrib.staticfiles，这个是Django处理静态文件的核心应用，默认是包含的，但最好确认一下。
• 确认STATIC_URL = '/static/'这个配置存在，这是静态文件在URL中的前缀，所有静态资源的访问路径都会基于这个前缀。
• 如果你把静态文件放在项目根目录的static文件夹下（而不是app内部的static），需要添加STATICFILES_DIRS配置：

  STATICFILES_DIRS = [
      BASE_DIR / "static",
  ]
  

2. 模板里引用图片的方式错了！这是关键问题 #

你现在的模板里应该是直接写了类似<img src="/exapp/pic.jpg">的代码，这就导致Django直接去网站根路径下找/exapp/pic.jpg，而不是去静态文件目录里找。正确的做法是用Django的静态文件模板标签：

• 先在模板的最顶部加载静态标签：

  {% load static %}
  

• 然后用标签生成正确的图片URL：

  <img src="{% static 'exapp/pic.jpg' %}" alt="你的图片描述">
  

这样Django会自动把STATIC_URL前缀加上，生成的路径就是/static/exapp/pic.jpg，正好对应你放在static/exapp/下的图片文件。

3. 核对你的文件结构是否正确 #

按照你的描述，文件结构应该是下面这样的（补全你给出的部分）：

├── db.sqlite3
├── exapp
│   ├── admin.py
│   ├── ...（其他app相关文件）
└── static
    └── exapp
        └── pic.jpg  <!-- 你的图片要放在这里 -->

或者如果你是把静态文件放在app内部的static目录，那结构应该是：

├── db.sqlite3
├── exapp
│   ├── admin.py
│   ├── ...（其他app相关文件）
│   └── static
│       └── exapp
│           └── pic.jpg

两种结构都可以，只要配置和模板引用正确就行。

4. 生产环境别忘了运行collectstatic #

如果你是在生产环境部署项目，记得运行下面的命令把所有静态文件收集到统一的目录（由STATIC_ROOT配置指定）：

python manage.py collectstatic

不过开发环境用python manage.py runserver的话，不需要这一步，Django会自动帮你找静态文件。

按照上面的步骤调整后，你的图片应该就能正常显示了！

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