Swift macOS：NSPrintInfo与NSAttributedString打印分页异常解决

我之前也碰到过一模一样的问题——打印长列表时，一行内容被硬生生拆在两页，看着特别别扭。这本质是打印引擎没识别到正确的分页断点，下面分几种常见场景给你具体的解决办法：

一、WebView/HTML页面打印（最常见的列表打印场景） #

1. 用CSS强制禁止元素内部分页 #

给你的列表项添加专门的打印样式，告诉打印设备不要在单个列表项内部拆分：

/* 兼容新旧浏览器的分页控制 */
.print-list-item {
  page-break-inside: avoid;
  break-inside: avoid;
}

/* 可选：给页面上下留边距，避免内容紧贴页眉页脚 */
@media print {
  body {
    margin-top: 2cm;
    margin-bottom: 2cm;
  }
}

page-break-inside: avoid是核心，它会确保整个列表项要么完全显示在当前页，要么整体移到下一页，不会出现截断的情况。

2. 优化列表项的HTML结构 #

别用span这类行内元素来包裹列表内容，也别给列表项设置固定高度——这些都会让打印引擎更容易拆分内容。尽量用块级元素，让内容自然撑开：

<ul class="print-list">
  <li class="print-list-item">这里是很长的列表内容，就算跨页也不会被截断...</li>
  <li class="print-list-item">另一段长内容，会完整显示在同一页...</li>
</ul>

二、原生Android打印 #

如果是用Android原生的PrintDocumentAdapter处理打印，得手动计算每页能容纳的行数，避免强行绘制超出页面的内容：

// 伪代码示例：分页计算绘制内容
int lineHeight = getTextLineHeight(); // 获取单行文本高度
int pageHeight = getPrintPageHeight(); // 获取打印页面的可用高度
int linesPerPage = pageHeight / lineHeight;

int currentLineIndex = 0;
int totalLines = getAllListLines().size();

while (currentLineIndex < totalLines) {
    // 绘制当前页的内容：从currentLineIndex到currentLineIndex + linesPerPage
    drawPageContent(currentLineIndex, Math.min(currentLineIndex + linesPerPage, totalLines));
    // 切换到下一页
    currentLineIndex += linesPerPage;
}

三、原生iOS打印 #

iOS里用UIPrintInteractionController打印时，优先用系统的文本格式化类，它们会自动处理分页逻辑：

// 伪代码示例：用系统打印格式化器处理长文本
let listContent = "你的所有列表内容拼接成的字符串"
let attributedText = NSAttributedString(string: listContent, attributes: [
    .font: UIFont.systemFont(ofSize: 12)
])

let printFormatter = UISimpleTextPrintFormatter(attributedText: attributedText)
// 设置页边距，避免内容太靠边
printFormatter.perPageContentInsets = UIEdgeInsets(top: 20, left: 20, bottom: 20, right: 20)

let printController = UIPrintInteractionController.shared
printController.printFormatter = printFormatter
printController.present(animated: true)

UISimpleTextPrintFormatter会自动识别文本的换行和分页，不会把一行拆在两页。

额外小贴士 #

• 先通过打印预览功能看效果，别直接打印浪费纸张；
• 如果是混合开发（比如React Native/Flutter），本质还是依赖WebView或原生打印能力，对应上面的方案调整就行。

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