本文讲解如何在 django 模板中优雅处理空查询集（如 `bookinstance_list` 为空时），避免逻辑错误，并使用 `{% for ... empty %}` 替代冗余的 `{% if %}` 判断，提升代码可读性与健壮性。
在你提供的 HTML 模板代码中，核心问题并非语法错误，而是逻辑结构与 Django 模板最佳实践的偏差：你使用了 {% if bookinstance_list %}...{% else %}...{% endif %} 包裹整个 <ul> 列表，这虽能运行，但存在两个关键缺陷：
- 语义错位：<ul> 元素本应始终存在（即使无子项），而你的写法在空数据时完全省略 <ul>，导致 DOM 结构不一致，可能影响 CSS 样式（如 ul { margin: 1rem 0; } 失效）、JavaScript 选择器或无障碍访问（screen reader 对空列表的识别）；
- 模板冗余：Django 提供了更简洁、语义更明确的 {% for ... empty %} 语法，专为“遍历集合 + 处理空情况”场景设计，无需额外条件判断。
✅ 正确做法是将 {% empty %} 直接嵌入 {% for %} 块内，确保 <ul> 始终渲染，仅内容动态变化：
<ul>
{% for bookinst in bookinstance_list %}
<li class="{% if bookinst.is_overdue %}text-danger{% endif %}">
<a href="{% url 'book-detail' bookinst.book.pk %}">{{ bookinst.book.title }}</a>
({{ bookinst.due_back }})
{% if user.is_staff %} — {{ bookinst.borrower }}{% endif %}
{% if perms.catalog.can_mark_returned %}
— <a href="{% url 'renew-book-librarian' bookinst.id %}">Renew</a>
{% endif %}
</li>
{% empty %}
<li class="text-muted fst-italic">— No books are currently borrowed.</li>
{% endfor %}
</ul>? 关键优势说明：
Java注释规范Skills
下载
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
- ✅ <ul> 标签恒定存在，CSS 和布局稳定；
- ✅ empty 分支自动触发当 bookinstance_list 为 None、空列表 [] 或空 QuerySet（如 BookInstance.objects.none()）；
- ✅ 语义清晰：for 关注“有数据时如何渲染”，empty 专注“无数据时的友好提示”，职责分离；
- ✅ 避免重复逻辑（如多次检查 user.is_staff 或权限标签无需在 empty 中重复）。
⚠️ 注意事项：
- 不要将 {% empty %} 与 {% if %} 混用嵌套——这会增加复杂度且违背模板设计意图；
- 确保视图中传递给模板的 bookinstance_list 是有效的 QuerySet 或列表（而非未定义变量），否则会触发 VariableDoesNotExist 错误（可在开发环境开启 DEBUG=True 查看详细报错）；
- 若需在空状态下显示非 <li> 内容（如独立段落或按钮），仍可包裹在 <ul> 内并用 text-center 等工具类修饰，保持语义完整性。
? 总结：Django 模板的 {% for ... empty %} 不仅是语法糖，更是表达“列表行为契约”的标准方式。采用它，你的模板更健壮、更易维护，也更符合官方推荐实践——正如 MDN Django 教程中所示范的那样。
