HTML 导出 PDF 文件的实用方法

在数字化转型的今天，将HTML转换为PDF已成为开发者必备技能。这种技术可完美保留网页布局，支持跨平台查看，适用于电子合同、数据报表、财务对账单等场景。通过精准的格式控制，既能保持视觉一致性，又能确保文档安全性和法律效力。

推荐指数：★★★★☆
通过JavaScript库实现浏览器端即时转换，特别适合需要即时预览的场景：
“`javascript
html2pdf()
.from(document.getElementById(‘content’))
.set({
margin: [15, 15],
filename: ‘document.pdf’,
image: { type: ‘jpeg’, quality: 0.98 },
html2canvas: { scale: 2 }
})
.save();
“`
核心参数说明：
margin：设置页边距（单位：毫米）
scale：渲染缩放比例（推荐2倍高清输出）
imageType：支持JPEG/PNG格式输出

推荐指数：★★★☆☆
利用CSS媒体查询控制打印样式：
“`css
@media print {
.noprint { display: none; }
header { page-break-after: always; }
}
“`
通过`window.print()`调用浏览器打印对话框，选择”另存为PDF”。

推荐指数：★★★★★
适合企业级应用的高精度转换：
“`java
public class PdfGenerator {
public static void createPdf(String html) throws Exception {
Document doc = new Document(PageSize.A4.rotate());
PdfWriter writer = PdfWriter.getInstance(doc, new FileOutputStream(“output.pdf”));

// 中文支持配置
XMLWorkerFontProvider fontProvider = new XMLWorkerFontProvider() {
public Font getFont(String fontname, String encoding,
boolean embedded, float size, int style) {
return FontFactory.getFont(“STSong-Light”, “UniGB-UCS2-H”, size);
}
};

doc.open();
XMLWorkerHelper.getInstance().parseXHtml(writer, doc,
new StringReader(html), null, fontProvider);
doc.close();
}
}
“`

推荐指数：★★★★☆
基于wkhtmltopdf的封装方案：
“`python
import pdfkit

config = pdfkit.configuration(wkhtmltopdf=’/usr/local/bin/wkhtmltopdf’)
options = {
‘encoding’: “UTF到8”,
‘page-size’: ‘A4’,
‘margin-top’: ’15mm’,
‘orientation’: ‘Landscape’
}

pdfkit.from_file(‘input.html’, ‘output.pdf’,
configuration=config, options=options)
“`

使用CSS控制分页：
“`css
.page-break {
page-break-after: always;
break-after: page;
}
“`

Java iText实现动态页眉：
“`java
class HeaderFooter extends PdfPageEventHelper {
public void onEndPage(PdfWriter writer, Document doc) {
ColumnText.showTextAligned(writer.getDirectContent(),
Element.ALIGN_CENTER, new Phrase(“机密文档第”+doc.getPageNumber()),
300, 30, 0);
}
}
“`

“`python
import schedule
import time

def batch_convert():
扫描指定目录下的HTML文件
for file in os.listdir(‘input’):
if file.endswith(‘.html’):
generate_pdf(os.path.join(‘input’, file))

schedule.every().day.at(“02:00”).do(batch_convert)

while True:
schedule.run_pending()
time.sleep(60)
“`

“`javascript
fetch(‘https://api.pdfgenerator.com/v1/create’, {
method: ‘POST’,
headers: {
‘Authorization’: ‘Bearer YOUR_API_KEY’,
‘Content-Type’: ‘application/json’
},
body: JSON.stringify({
html: ‘

‘,
options: {
format: ‘A4′,
margin: ’20mm’
}
})
})
“`

1. 字体嵌入：确保中文字体包已正确加载
2. 分辨率控制：设置300dpi以上保证打印质量
3. 错误处理：添加异常捕获机制
“`java
try {
// 转换代码
} catch (DocumentException | IOException e) {
logger.error(“PDF生成失败: ” + e.getMessage());
throw new PDFGenerationException(“文档生成失败”);
}
“`
4. 性能优化：对10页以上文档启用分片处理
5. 安全加固：添加水印和密码保护敏感文档

通过结合具体业务场景选择合适的方案，开发者可以构建稳定高效的HTML转PDF系统。建议先用客户端方案快速验证需求，再逐步升级到服务端方案保障企业级应用的稳定性和安全性。