如何让Middleman的config.rb中嵌套循环正常运行？

算力阿峰

2026-5-8

解决Middleman嵌套循环内层不执行的问题

我之前在使用Middleman处理contentful导入的数据时，也碰到过几乎一模一样的问题！核心原因应该是Middleman::Util::EnhancedHash这个自定义哈希实现的迭代机制限制——它的each方法不支持嵌套重入调用，当外层循环还在遍历这个对象时，内层再调用同一个对象的each会直接跳过。

快速修复方案

把EnhancedHash转换成普通的Ruby哈希或数组，再进行嵌套循环：

方案1：转成普通哈希遍历

# 先将EnhancedHash转为原生哈希
datatype_hash = data.site.datatype.to_h

datatype_hash.each do |id, c|
  puts c
  # 内层遍历转换后的原生哈希，就能正常执行了
  datatype_hash.each do |id2, c2|
    puts c2
  end
end

方案2：提取所有值到数组遍历

如果不需要键（id），也可以直接提取值到数组：

# 提取所有数据项到数组
datatype_items = data.site.datatype.values.to_a

datatype_items.each do |c|
  puts c
  datatype_items.each do |c2|
    puts c2
  end
end

为什么会出现这个问题？

Middleman的EnhancedHash是对原生哈希的封装，主要是为了在模板里更方便地调用数据（比如用点语法c.name代替哈希键调用c[:name]）。但它的迭代器实现没有考虑嵌套调用的场景——当外层each启动后，迭代器的状态被占用，内层调用同一个对象的each时会直接终止，导致内层循环完全不执行。

而转换成原生哈希/数组后，使用的是Ruby原生的迭代方法，完全支持嵌套遍历，问题就解决了。