Jekyll递归include渲染嵌套评论触发“Nesting too deep”错误

1. 为什么数据结构正常还会报错？ #

Jekyll基于Liquid模板引擎，为了避免无限递归导致的栈溢出，默认给include的递归深度设置了上限（通常是5层）。你的评论嵌套到了6-7层，已经超过这个默认限制，哪怕数据关联完全正确，也会触发该错误。

2. 如何修复“Nesting too deep”错误？ #

有两种直接的解决思路：

方法一：提高Jekyll的递归限制阈值 #

在站点根目录的_config.yml中添加或修改Liquid配置，手动提高递归深度上限：

liquid:
  recursion_limit: 10  # 根据实际最大嵌套层数设置，10足够覆盖6-7层的需求

注意：不要把阈值设得过大，否则遇到意外的无限递归时可能导致构建崩溃。

方法二：改用非递归的迭代式渲染 #

放弃递归include，先把所有评论构建成树状结构，再逐层迭代渲染：

1. 预构建评论树：在页面模板或单独的include中，遍历所有评论，建立以slug为键、包含子评论列表的对象：

{% assign comment_tree = {} %}
{% for comment in site.comments %}
  {% unless comment_tree[comment.parent] %}
    {% assign comment_tree[comment.parent] = empty | push: comment %}
  {% else %}
    {% assign comment_tree[comment.parent] = comment_tree[comment.parent] | push: comment %}
  {% endunless %}
{% endfor %}

2. 迭代渲染评论：用分层遍历的方式，先渲染根评论（假设根评论的parent为空字符串或对应文章ID），再依次渲染每一层的子评论：

{% assign current_level = comment_tree[""] | default: empty %}
{% while current_level.size > 0 %}
  {% assign next_level = empty %}
  {% for comment in current_level %}
    <div class="px-0 text-sm">
      <div class="mb-1">
        <a href="#" class="text-text-muted no-underline text-sm leading-none inline-block pt-0.5 hover:text-link-hover">▲</a>
        <small class="text-text-muted ml-2 text-sm">@{{ comment.author }}</small>
        <small class="text-text-muted ml-2 text-sm">{{ comment.date | date: "%b %d, %Y" }} | <a href="#" class="ml-2 text-xs text-primary hover:underline">parent</a> | <a href="#" class="ml-2 text-xs text-primary hover:underline">next</a></small>
      </div>
      <div>
        <p>{{ comment.content }}</p>
        <small class="text-right underline text-xs cursor-pointer mt-1 inline-block">reply</small>
      </div>
      <!-- 收集下一层子评论并添加缩进容器 -->
      {% assign replies = comment_tree[comment.slug] | default: empty %}
      {% if replies.size > 0 %}
        {% assign next_level = next_level | concat: replies %}
        <div class="ml-2 mt-4 border-l-2 border-gray-200 pl-2 text-sm md:pl-4">
          <!-- 子评论将在下一轮循环中渲染 -->
        </div>
      {% endif %}
    </div>
  {% endfor %}
  {% assign current_level = next_level %}
{% endwhile %}

这种方式完全避开递归include，自然不会触发深度限制。

3. 更优的Jekyll嵌套评论渲染方案？ #

最推荐预构建树状结构+迭代渲染的方案，原因有两点：

• 彻底规避Jekyll的递归限制，支持任意深度的嵌套评论；
• 性能更优：递归渲染每次都要调用site.comments | where查询子评论，而预构建树只需要遍历一次所有评论，后续直接通过键值对获取子评论，减少了重复查询的开销。

如果站点规模较大，也可以借助Ruby插件在构建时预处理评论数据，直接生成树状结构，但对于普通静态站点来说，Liquid层面的预构建已经足够满足需求。

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