OpenTBS Excel MergeBlock合并单元格未下移致格式异常的解决方法

当使用OpenTBS的MergeBlock填充Excel数据行时，若模板中合并单元格位于行占位符下方，常会出现内容下移但合并格式留在原位置的问题——比如你用官方演示模板测试时，D22的合并单元格内容移到了24行，但合并格式仍卡在D22，导致数据显示变形、合并状态失效。

下面提供两种可行的解决方法：

方法一：调整模板结构，让合并单元格随MergeBlock自动同步 #

把需要保留的合并单元格行，和数据行占位符关联起来，用OpenTBS的block=end标记实现“数据行结束后自动追加并下移”：

1. 在模板中，将合并单元格所在的行放在数据行占位符的紧下方。
2. 在该行的任意单元格（比如合并区域内）添加占位符：[onshow;block=end]。

这样OpenTBS在处理MergeBlock时，会自动识别这是数据块的结束行，不仅会将该行下移到数据行之后，还会完整保留合并单元格的格式，无需额外代码。

方法二：用回调函数手动更新合并区域坐标 #

如果模板结构无法调整，可通过OpenTBS的回调函数，在MergeBlock执行后计算偏移行数，手动修正合并单元格的位置：

1. 定义回调函数，用于更新合并区域：

function fix_merge_cells($TBS, $BlockName, $CurrRec, $RecNum, $BlockInfo) {
    // 原模板中合并单元格的区域（示例为D22:F22）
    $original_ref = 'D22:F22';
    // 拆分原始区域的行号和列范围
    preg_match('/([A-Z]+)(\d+):([A-Z]+)(\d+)/', $original_ref, $matches);
    $start_col = $matches[1];
    $original_start_row = (int)$matches[2];
    $end_col = $matches[3];
    $original_end_row = (int)$matches[4];

    // 计算新增的行数（MergeBlock生成的总行数减1）
    $added_rows = $RecNum - 1;
    if ($added_rows <= 0) return;

    // 获取当前工作表对象
    $sheet = $TBS->PlugIn(OPENTBS_GET_SHEET);
    // 移除旧的合并区域
    $sheet->unmergeCells($original_ref);
    // 计算新的合并区域坐标
    $new_start_row = $original_start_row + $added_rows;
    $new_end_row = $original_end_row + $added_rows;
    $new_ref = "$start_col$new_start_row:$end_col$new_end_row";
    // 应用新的合并区域
    $sheet->mergeCells($new_ref);
}

2. 在调用MergeBlock前，注册回调：

$TBS->Plugin(TBS_INSTALL, OPENTBS_CALLBACK_ON_MERGE_BLOCK, 'fix_merge_cells');

这个方法会在每次MergeBlock执行后，自动把原合并区域的位置下移对应行数，确保格式和内容匹配。

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