在 Django 模板中，若需根据数据是否存在动态渲染列表（）或独立提示语（如 No deeds here yet），应避免使用 {% for ... empty %} 将提示嵌套在列表内部，而应改用 {% if %} 条件判断，在列表结构外统一控制渲染逻辑。

在 django 模板中，若需根据数据是否存在动态渲染列表（`

`）或独立提示语（如 `

no deeds here yet

`），应避免使用 `{% for ... empty %}` 将提示嵌套在列表内部，而应改用 `{% if %}` 条件判断，在列表结构外统一控制渲染逻辑。

Django 模板的 {% for ... empty %} 语法虽简洁，但其 empty 分支始终作为

的子元素渲染——这会导致语义错误（非列表项被包裹在
中）、样式干扰（如默认上下边距、列表样式继承）及可访问性问题（屏幕阅读器误读为列表内容）。正确的做法是先判断数据是否存在，再决定渲染整个列表结构还是纯提示文本。

以下是推荐的重构写法：

{% extends "todo_lists/base.html" %}
{% block content %}
    <h2>Deeds of a {{ list_title }} list</h2>
    {% if deeds %}
        

{% for deed in deeds %}
• {{ deed.title }}
{% endfor %}

{% else %}

No deeds here yet

HTML Extract

使用 MinerU 从 HTML 页面和文件中提取内容，将 HTML 转换为保持标题、列表、表格及文本层次结构的干净、结构化 Markdown。F...

下载

{% endif %} {% endblock content %}

✅ 优势说明：

• 语义清晰：

  不再是

  的非法子元素，符合 HTML5 规范；
• 样式可控：提示段落完全脱离列表上下文，可自由设置 margin、color 等样式；
• 逻辑明确：模板层级扁平，条件分支一目了然，便于后续扩展（例如添加按钮、图标或不同空状态文案）；
• 性能友好：仅一次变量检查（deeds），无重复遍历开销。

⚠️ 注意事项：

• 确保视图中传递的 deeds 是可迭代对象（如 QuerySet 或空列表），而非 None —— 若可能为 None，建议在视图中显式初始化为 []，或在模板中使用 {% if deeds and deeds|length > 0 %} 增强健壮性；
• 如需复用该逻辑，可将其封装为自定义模板标签或包含模板（{% include "snippets/deed_list.html" %}），提升可维护性。

通过这种结构化条件渲染，你不仅能解决当前布局问题，还能为未来功能迭代（如加载状态、分页提示、筛选空态）奠定清晰的模板架构基础。

前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！