Handlebars.NET嵌套循环@last判断异常，CSV生成格式错误排查

看起来你遇到的问题是因为Handlebars.NET在遍历.NET对象属性时，嵌套each块中的@last变量没有正确绑定到当前内层循环的上下文，反而意外继承了外层循环的@last状态。这就导致：

• 当外层rows循环的元素不是最后一个时，内层循环的所有元素都会输出分号（包括最后一个属性），所以行尾多了分号；
• 当外层rows循环的元素是最后一个时，内层循环的所有元素都不会输出分号，所以属性值直接拼接在一起。

解决方案 #

有两种简单的方式可以解决这个问题：

方案1：将对象属性转为数组遍历 #

把item对象的属性值转为数组，这样内层each遍历的是数组而非对象，@last会正确指向数组的最后一个元素：

修改data的定义，将rows改为字符串数组的数组：

var data = new {
    header = new string [] { "Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat" },
    rows = new [] {
        new string[] { "A", "B", "C", "D", "E", "F", "G" },
        new string[] { "A", "B", "C", "D", "E", "F", "G" },
        new string[] { "A", "B", "C", "D", "E", "F", "G" },
        new string[] { "A", "B", "C", "D", "E", "F", "G" },
        new string[] { "A", "B", "C", "D", "E", "F", "G" },
        new string[] { "A", "B", "C", "D", "E", "F", "G" },
        new string[] { "A", "B", "C", "D", "E", "F", "G" }
    }
};

原模板不需要修改，这样输出就会符合你的预期。

方案2：自定义join助手（更简洁） #

Handlebars.NET支持自定义助手，我们可以写一个join助手来直接将数组或对象的属性值用指定分隔符连接，完全避免嵌套循环的问题：

首先注册join助手：

var handlebarsInstance = Handlebars.Create(new HandlebarsConfiguration {TextEncoder = new CsvEncoder()});
handlebarsInstance.RegisterHelper("join", (writer, context, args) => {
    if (args.Length == 0) return;
    // 默认分隔符为逗号，可传入第二个参数指定
    var separator = args.Length > 1 ? args[1].ToString() : ",";
    
    if (args[0] is IEnumerable enumerable) {
        // 处理数组/集合
        var items = enumerable.Cast<object>()
                              .Select(o => o?.ToString() ?? string.Empty)
                              .ToArray();
        writer.Write(string.Join(separator, items));
    } else if (args[0] is object obj) {
        // 处理对象，遍历所有公开实例属性
        var props = obj.GetType().GetProperties(System.Reflection.BindingFlags.Public | System.Reflection.BindingFlags.Instance)
                       .Select(p => p.GetValue(obj)?.ToString() ?? string.Empty);
        writer.Write(string.Join(separator, props));
    }
});

然后简化模板：

string template = "{{join header ';'}}\n{{#each rows}}{{join this ';'}}\n{{/each}}\n\n\n\n\n\n";

这样模板更简洁，输出也完全符合预期。

关于问题根源 #

这个问题更倾向于Handlebars.NET在遍历.NET对象时的上下文变量绑定bug，因为标准Handlebars规范中，@last应该是当前each块的局部变量，不会被外层上下文覆盖。不过通过上述两种方案可以轻松规避这个问题。

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