使用Handlebarsjs实现固定宽度文本输出的最佳方案咨询

以下是两种可直接落地的实现方案：

方案1：自定义Handlebars辅助函数 （推荐） #

该方案复用性最强，适合行数多、多处需要用到固定宽度格式化的场景，核心是把行宽计算、文本截断续行、空格填充的逻辑封装成全局辅助函数，模板直接调用即可。
首先注册辅助函数，代码如下：

// 注册全局handlebars辅助函数 fixedWidthRow
Handlebars.registerHelper('fixedWidthRow', function(rowLabel, content, options) {
  const TOTAL_WIDTH = 60; // 预设总宽度60字符
  const PREFIX = `  /* ${rowLabel}: `;
  const SUFFIX = ' */';
  const availableWidth = TOTAL_WIDTH - PREFIX.length - SUFFIX.length;
  let output = [];
  let remainingContent = content;

  // 处理第一行
  if (remainingContent.length <= availableWidth) {
    const padded = remainingContent.padEnd(availableWidth, ' ');
    output.push(`${PREFIX}${padded}${SUFFIX}`);
  } else {
    // 截断第一行，末尾加续行符+
    const firstLine = remainingContent.slice(0, availableWidth - 1) + '+';
    output.push(`${PREFIX}${firstLine}${SUFFIX}`);
    remainingContent = remainingContent.slice(availableWidth - 1);
    // 处理剩余续行
    while (remainingContent.length > 0) {
      const lineContent = remainingContent.slice(0, availableWidth).padEnd(availableWidth, ' ');
      output.push(`  /* ${lineContent}${SUFFIX}`);
      remainingContent = remainingContent.slice(availableWidth);
    }
  }
  return output.join('\n');
});

模板使用方式如下：

/* ---------------------------------------------------- */
  {{fixedWidthRow "Row 1" var1}}
  {{fixedWidthRow "Row 2" var2}}
  /* ---------------------------------------------------- */

该实现完全匹配你给出的期望输出效果，变量长度不足时自动补空格，超出时自动加续行符拆分多行。

方案2：渲染前预处理变量 #

如果你的场景行数很少，不想引入全局辅助函数，可以在渲染模板前提前处理好所有变量的换行、填充逻辑，把处理好的行内容直接传入模板即可。
处理逻辑和上述辅助函数的逻辑一致，只是提前在业务代码里完成计算，模板里直接输出预处理后的每行内容即可，适合临时使用、不需要复用的场景。

注意事项 #

• 如果内容包含全角字符（比如中文、全角标点），需要额外调整字符宽度计算逻辑，一个全角字符占2个半角字符宽度，避免实际渲染时超出预设宽度。
• 可根据实际需求调整续行符号、总宽度、前后缀的配置，不需要硬编码在辅助函数里，也可以做成参数传入。

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