Go gofpdf Cell与MultiCell怎样改变当前位置

用 gofpdf 排 PDF 时，Cell 和 MultiCell 的关键差异不在“能不能换行”，而在一次调用结束后当前位置落在哪里：Cell 默认把 X 坐标向右推进，MultiCell 完成整个文本块后把 X 放回左边距、Y 移到下一行。表格想继续写右侧列，优先用 Cell 或 CellFormat；段落需要自动折行，才用 MultiCell，并提前保存坐标。

先看一次调用后的 X/Y 变化

官方文档把单元格左上角定义为当前位置。Cell(w, h, txt) 是简化版调用，内部使用 CellFormat，没有边框、填充和链接参数，默认不换到下一行，所以调用后通常是 x += w，Y 保持在当前行。若宽度传 0，单元格会延伸到右边距，但当前位置的推进仍要结合页面可用宽度判断。

CellFormat 的 ln 参数更适合需要明确布局契约的代码：

而 MultiCell(w, h, text, border, align, fill) 会把文本按宽度自动或按 \n 显式拆成多个单元格逐行绘制。官方说明它结束后位于下一行开头，相当于单元格调用后再执行一次回到左边距的换行。它解决的是段落折行，不是“在当前行继续放下一列”。

表格不要直接把 MultiCell 当作下一列

下面的写法展示短字段用 CellFormat 横向推进，记录结束时用 ln=1 统一换行。代码中的注释只保留关键布局意图：

package main

import (
    "log"
    "github.com/jung-kurt/gofpdf"
)

func main() {
    pdf := gofpdf.New("P", "mm", "A4", "")
    pdf.SetFont("Arial", "", 11) // 先选字体，否则 Cell 可能设置错误
    pdf.AddPage()

    pdf.CellFormat(45, 8, "服务", "1", 0, "L", false, 0, "") // ln=0，继续向右
    pdf.CellFormat(45, 8, "状态", "1", 1, "L", false, 0, "") // ln=1，整行结束
    pdf.MultiCell(90, 6, "这是需要自动折行的说明文本。", "1", "L", false)
    pdf.Ln(-1) // -1 使用上一格的高度，适合段落后再留一行

    if err := pdf.OutputFileAndClose("example.pdf"); err != nil {
        log.Fatal(err) // 输出失败要停止，避免把不完整文件当作成功结果
    }
}

如果在 MultiCell 后直接调用下一次 Cell，它会从左边距的新行开始，而不会接在上一段右侧。这个行为不是异常，正是其 API 契约。要做两列多行表格，应先记录起始坐标和每列文本高度，再逐列用 SetXY 绘制。

多行单元格的稳定布局方式

多行表格的难点是每列折行数量不同。可以用 SplitLines 预估每列所需行数，取最大高度作为整行高度；真正绘制时从同一个 y 开始，列的每个文本片段都用固定的 x 和 y 写入。这样不会让某一列的 MultiCell 把公共游标带到下一行后再影响另一列。

如果只是左栏标题、右栏说明的固定结构，也可以先保存：

startX, startY := pdf.GetXY() // 记录这一行的共同起点
pdf.MultiCell(55, 6, leftText, "1", "L", false)
pdf.SetXY(startX+60, startY) // 右栏回到同一行的起点
pdf.MultiCell(55, 6, rightText, "1", "L", false)
pdf.SetXY(startX, startY+rowHeight) // rowHeight 应由两列最大行数计算

这里的 rowHeight 不能凭经验写死。字体、字号、单元格内边距和文本中的显式换行都会改变实际高度；中文字体还会影响可用宽度。需要更精细控制时，把边框矩形和文字片段分开绘制，位置会更可预测。

几个容易误判的边界

• 宽度为 0：MultiCell 会使用当前位置到右边距的可用宽度；如果先改变了 X，再调用它，折行宽度也会跟着变。
• Ln(-1)：负值使用最近一次单元格高度；它不是固定的 1 行，前一次是多行单元格时下移量可能比预期大。
• 自动分页：单元格超出分页触发点时，gofpdf 可能在输出前自动加页。排查错位时同时记录页码、GetXY() 和单元格高度。
• 尾部换行：官方文档提示 UTF-8 字体和非 UTF-8 字体对文本末尾多个换行的处理存在差异；依赖一致行为时，调用前显式 strings.TrimRight(text, "\r\n")。

排查顺序与相关问题

1. 先问：当前调用是要右移、换行，还是自动折行？
2. 打印调用前后的 GetXY()，确认是否真的由当前单元格改变。
3. 核对 w、h、CellMargin、字体和显式换行；最后再检查自动分页。

Cell 后怎样换到下一行？用 CellFormat 的 ln=1，或调用 Ln(-1)；后者会使用最近一次单元格高度。

MultiCell 后怎样继续同一行？在调用前保存 GetXY()，下一列用 SetXY 恢复到目标 X/Y，并用统一的行高管理整行。