Django 5静态文件图片无法显示问题求助

核心问题排查与修复 #

1. 修正settings.py的静态目录配置 #

你写错了静态目录的配置变量名，且路径拼接错误：

# 原错误代码
STATIC_DIR = Path(BASE_DIR, "static")
STATIC_DIRS = [
    STATIC_DIR / "static",
]

正确配置如下：

BASE_DIR = Path(__file__).resolve().parent.parent
STATIC_URL = 'static/'
# 变量名是STATICFILES_DIRS，直接指向项目根目录下的static文件夹
STATICFILES_DIRS = [
    BASE_DIR / "static",
]

2. 修正HTML中的路径分隔符 #

Web路径需用正斜杠/，替换原代码中的反斜杠\：

{% load static %}
<body>
    <img src="{% static 'images/house_of_functions_hawkeye.jpg' %}" alt="House of Functions">
    <div class="container">
        <h1 id="main__title">Welcome to House of functions</h1>
    </div>
</body>

3. 确认目录结构正确性 #

确保项目目录符合Django静态文件的约定：

项目根目录/
├── static/
│   └── images/
│       └── house_of_functions_hawkeye.jpg
├── templates/
├── 应用目录/
└── settings.py

4. 验证本地服务配置 #

本地开发时保持settings.py中DEBUG = True，重启Django开发服务器，让配置生效。同时可通过浏览器开发者工具（F12）查看「网络」标签，确认图片的请求路径是否正确，若返回404则重新核对路径配置。

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