Django加载静态文件遇TemplateSyntaxError，求解决方法

首先，咱们梳理下你遇到的核心问题：在模板中使用static标签加载图片时触发了TemplateSyntaxError，提示“无效的块标签'static'，预期为'endblock'”。结合你给出的代码和配置，我来一步步帮你排查解决：

问题根源分析 #

这个报错的核心原因大概率是静态文件模板标签的加载方式与Django版本不兼容，或是配置细节没匹配到位。咱们先从最关键的模板代码入手调整：

解决方案步骤 #

1. 统一静态文件加载标签 #

Django 1.10版本后就弃用了{% load staticfiles %}，将其功能合并到了{% load static %}中。你同时加载两个标签可能会导致冲突，直接修改模板代码，只保留一个加载指令即可：

{% load static %}
<img class="logo" alt="Test Pic" src="{% static 'images/logo.png' %}" width="110" height="70">
{% block main %}
{% endblock %}

2. 修正开发环境的静态文件配置 #

你当前配置的STATIC_ROOT是部署阶段用来收集所有静态文件的目录，开发环境下用它反而可能让Django找不到你的静态文件。建议调整配置如下：

# settings.py
INSTALLED_APPS = [
    ...,
    'django.contrib.staticfiles',  # 确认这个应用已经添加
]

STATIC_URL = '/public/'
# 开发环境下，用STATICFILES_DIRS指定静态文件的实际存放路径
# 假设你的图片放在项目根目录的`static/images/`下
STATICFILES_DIRS = [
    os.path.join(BASE_DIR, 'static'),
]
# STATIC_ROOT仅在部署时启用，开发阶段可以注释掉
# STATIC_ROOT = os.path.join(BASE_DIR, "public")

3. 简化URL配置（可选） #

在开发环境中，只要DEBUG = True且django.contrib.staticfiles在INSTALLED_APPS里，Django会自动处理静态文件的路由，你可以简化URL配置：

# urls.py
from django.conf import settings
from django.conf.urls.static import static
from django.urls import path

urlpatterns = [
    # 你的其他业务路由
]

# 仅保留媒体文件的静态路由即可，静态文件由staticfiles自动处理
urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

4. 验证静态文件实际路径 #

确保你的图片文件确实存放在指定位置：如果STATICFILES_DIRS指向项目根目录的static文件夹，那么图片的物理路径应该是static/images/logo.png，这样{% static 'images/logo.png' %}才能正确解析为/public/images/logo.png。

最后测试 #

修改完以上内容后，重启你的Django开发服务器，刷新页面看看是否还会报错。如果问题依旧，可以检查下你的Django版本（运行python -m django --version），确保是1.10及以上版本。

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