Django静态图片无法加载，求正确静态文件夹配置及目录结构方案

1. 核心错误：模板语法使用不当 #

你当前在{% static %}模板标签中嵌套了{{ }}变量输出语法，这是不被Django模板系统支持的，属于语法错误。

修复方案： #

首先确保你的index.html最顶部已经加载静态文件标签：

{% load static %}

再把img的src属性修改为用字符串拼接过滤器实现路径拼接：

src="{% static 'Pizza/'|add:pizza %}"

2. 其余配置问题修正 #

2.1 确保应用已注册 #

检查settings.py的INSTALLED_APPS列表中已经添加了你的pizza应用：

INSTALLED_APPS = [
    # 原有默认系统应用
    'pizza',
]

只有注册后的应用，Django才会自动扫描应用下的static文件夹查找静态资源。

2.2 补充全局静态文件查找配置（可选） #

如果你后续需要在项目根目录存放公共静态文件，可在settings.py中添加STATICFILES_DIRS配置：

STATICFILES_DIRS = [
    os.path.join(BASE_DIR, 'static'),
]

注意：STATIC_ROOT是生产环境执行python manage.py collectstatic命令时，所有静态文件的统一导出目录，开发阶段不会生效，不要用它来配置开发环境的静态文件查找路径。

2.3 views.py路径写法修正 #

你当前用相对路径读取文件夹容易出现工作目录不一致导致的报错，修改为绝对路径写法：

import os
from django.conf import settings

def index(request):
    pizza_list = []
    # 拼接绝对路径，避免相对路径出错
    pizza_img_dir = os.path.join(settings.BASE_DIR, 'pizza', 'static', 'Pizza')
    for item in os.listdir(pizza_img_dir):
        # 过滤掉可能的隐藏文件或者子目录
        if os.path.isfile(os.path.join(pizza_img_dir, item)):
            pizza_list.append(item)
    context = {'pizza_list':pizza_list}
    return render(request,'index.html',context)

2.4 静态路由说明 #

你在urls.py中添加的静态文件路由仅适用于开发调试阶段，生产环境请用Nginx等Web服务器托管静态资源即可。 #

3. 最优静态文件目录结构推荐 #

Main_Project (项目根目录，和manage.py同级)
├── Main_Project (项目配置文件夹)
│   ├── __init__.py
│   ├── settings.py
│   ├── urls.py
│   └── wsgi.py
├── pizza (业务应用)
│   ├── static (应用私有静态文件，Django默认扫描)
│   │   └── Pizza
│   │       ├── 图片1.jpg
│   │       └── 图片2.jpg
│   ├── templates (应用私有模板)
│   ├── views.py
│   ├── models.py
│   └── urls.py
├── static (项目全局公共静态文件，需要配置STATICFILES_DIRS才会扫描)
│   ├── css
│   ├── js
│   └── img
├── media (用户上传文件存放目录)
└── manage.py

• 开发阶段：Django会自动从应用的static目录、配置的STATICFILES_DIRS目录查找静态文件
• 生产阶段：执行collectstatic命令后，所有静态文件会统一导出到STATIC_ROOT配置的目录，交给反向代理服务托管即可

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