Pdf-Lib中setText方法无法识别换行符，寻求解决方案

问题描述 #

使用Pdf-Lib处理PDF表单时，为文本字段设置带换行的内容后，换行符失效，内容始终显示为一行。相关代码及尝试如下：

加载PDF与获取字段的代码：

const pdfDoc = await PDFDocument.load(pdfBuffer);
const form = pdfDoc.getForm();

const attestorDetails = form.getTextField('AttestorDetails');

尝试的三种换行写法（均无效）：
1.

attestorDetails.setText(
[`Liang Mula & Co.`, `Advocates & Co.`].join('\n'),
);

attestorDetails.setText(
`Liang Mula & Co. \nAdvocates & Co.`
);

attestorDetails.setText(
`Liang Mula & Co. \n \r Advocates & Co.`
);

同时试过\r\n写法，最终内容均显示为：

Liang Mula & Co. Advocates & Solicitors

未达到预期的换行效果。

解决方法 #

问题核心是目标文本字段未开启多行模式。PDF表单默认的文本字段为单行模式，会自动忽略换行符并将内容合并为一行。

只需在设置文本前，调用字段的setMultiline(true)方法开启多行支持，修改后的代码如下：

const pdfDoc = await PDFDocument.load(pdfBuffer);
const form = pdfDoc.getForm();

const attestorDetails = form.getTextField('AttestorDetails');
// 开启文本字段的多行模式
attestorDetails.setMultiline(true);
// 设置带换行的文本（使用\n即可）
attestorDetails.setText(`Liang Mula & Co.\nAdvocates & Co.`);

// 保存修改后的PDF
const modifiedPdfBuffer = await pdfDoc.save();

额外注意事项：

• 确保原始PDF中的目标字段布局宽度足够容纳换行后的内容，否则可能出现内容截断；
• PDF表单处理中，标准换行符为\n，无需使用\r或\r\n。

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