Go gofpdf 怎样用MultiCell绘制自动折行文本

gofpdf的MultiCell可以把长文本放进固定宽度的多行文本块：先设置字体和位置，再传入块宽w、每行高度h及正文。文本超过可用宽度时自动折行，也可以用换行字符显式断行。h是每一行的高度，不是整个段落的固定总高度。

官方包地址：https://pkg.go.dev/github.com/jung-kurt/gofpdf。本文固定使用v1.16.2说明这一既有能力，不把它描述成新版本发布。以下示例采用核心字体支持的英文正文，以便先把折行与字体编码两个问题分开。

从单行Cell改为固定宽度文本块

假设要在送货说明中放一段长文字，原来一个单行Cell不能满足段落排版。改用MultiCell后，变化是“一次调用可以产生多行”，并且绘制后的当前位置也发生变化。不能只替换方法名，却继续按单行高度安排下方签名。

这种写法适合说明段落、备注区等固定宽度文本。它不是自动表格行布局器：多列需要统一行高或跨页时，还要由应用管理各列坐标与分页策略。

折行需要哪些尺寸和字体信息

本例New使用mm，所以宽80、行高6都表示毫米；SetFont的12仍表示12点。需要更改文本左右内边距时使用SetCellMargin，不能把它和SetMargins设置的页边距混为一谈。

完整示例：长说明文字自动换行

在新目录初始化模块，已有模块跳过初始化，保存下方main.go。边框参数“1”便于观察整块区域，左对齐“L”保持英文说明的自然阅读顺序，false表示不填充背景。

# 仅在新的示例目录创建模块
go mod init example.com/wrapped-note
# 固定本文示例依赖版本
go get github.com/jung-kurt/gofpdf@v1.16.2

package main

import (
    "fmt"
    "log"
    "strings"

    "github.com/jung-kurt/gofpdf"
)

func run() error {
    // 页面坐标与行高均使用毫米；SetFont的字号仍使用点。
    pdf := gofpdf.New("P", "mm", "A4", "")
    pdf.SetMargins(20, 20, 20)
    pdf.SetAutoPageBreak(true, 20)
    pdf.AddPage()
    pdf.SetFont("Helvetica", "", 12)

    text := "Delivery note: keep this document with the parcel. " +
        "Check the item count before accepting the shipment. " +
        "If an item is missing, record the package reference and contact support."
    // 只去除末尾换行，段内换行仍可作为显式断行。
    text = strings.TrimRight(text, "\r\n")
    const blockX = 30.0
    const blockWidth = 80.0
    const lineHeight = 6.0
    pdf.SetXY(blockX, 30)
    pdf.MultiCell(blockWidth, lineHeight, text, "1", "L", false)

    // MultiCell后已到下一行；用实际GetY衔接，不猜总行数。
    nextY := pdf.GetY()
    pdf.SetXY(blockX, nextY+4)
    pdf.MultiCell(blockWidth, lineHeight, "Reviewed by: __________", "", "L", false)
    if err := pdf.Error(); err != nil {
        return fmt.Errorf("绘制文本失败: %w", err)
    }
    // 输出方法会完成文档关闭，并返回生成或写文件错误。
    if err := pdf.OutputFileAndClose("wrapped-note.pdf"); err != nil {
        return fmt.Errorf("保存PDF失败: %w", err)
    }
    return nil
}

func main() {
    if err := run(); err != nil {
        log.Fatal(err)
    }
}

blockX为30，而左页边距为20，这里故意让两者不同：MultiCell结束后，不能假定下一段仍从30开始。通过GetY取得当前纵坐标，再用SetXY恢复blockX，可以让第二个文本块与第一块左边缘一致。

替换旧代码时先处理坐标与字体

第一项影响是坐标：MultiCell后位置位于下一行开头，X回到左页边距。原来的单行布局若期待内容继续写在右侧，就需要重新设计定位；不要再用固定的一行高度作为段落占高。

第二项是编码：若要写中文，核心Helvetica并不解决中文字形问题，应另行加载覆盖所需字符的UTF-8字体，再选择该字体。折行功能不等于内置中文字体，本文示例不依赖外部字体文件。

第三项是尾部换行：官方文档说明UTF-8字体与非UTF-8字体对末尾换行的处理存在差异。如果业务不需要末尾空行，可像示例一样显式TrimRight，再绘制；段间距用坐标或间距控制，不靠堆积末尾换行。

开启自动分页后，长段落可能进入新页，GetY反映的是当前页的坐标，不是跨页累计高度。本例只演示短备注衔接；如果要确保整个备注和签名不拆页，应先结合可用页高设计分页，而不是绘制完再把坐标强行移回上一页。

输出后应该怎样判断效果

# 生成示例PDF，错误会通过程序返回
go run .

预期得到wrapped-note.pdf：英文说明在80毫米宽的带框文本块内形成多行，下方Reviewed by文本与该块左边缘对齐。具体行数由字体、字号、文本与宽度共同决定，本文不提供虚构的运行行数或页面截图。代码未在本文环境执行，两张图仅说明参数与坐标关系。

为什么增大h没有让文字变大？

h控制每行的纵向高度，字体大小由SetFont或字号相关方法控制。增大行高主要增加行间空间。

为什么第二段回到了更左边？

MultiCell会回到左页边距；若文本块从自定义X开始，下一块需要显式恢复X。

能先估算文本占高吗？

可根据所用字体和编码选择SplitLines或SplitText等辅助方法。估算与实际绘制应使用一致的字体、字号、宽度和文本处理；跨页布局还需单独考虑页边界。

参数和坐标语义参考MultiCell官方API文档，字体、页边距和输出行为参考gofpdf实现与注释。示例场景和代码为本文独立编写。