html能不能自定义尺寸转pdf_自定义尺寸转法【要点】

能，但需依赖 pdf 生成工具设置而非 html；Puppeteer 用字符串单位如”80mm”，wkhtmltopdf 严格区分单位大小写，@page 规则支持度有限且常被覆盖。

HTML 转 PDF 时能否指定任意尺寸（如 80mm × 210mm）

能，但关键不在 HTML 本身，而在 PDF 生成工具的页面设置环节。HTML 的 @page 规则支持自定义尺寸，但仅当生成工具（如 Puppeteer、wkhtmltopdf、Weasyprint）启用并尊重该规则时才生效；浏览器原生“打印为 PDF”基本忽略非标准尺寸。

Puppeteer 中用 paperWidth/paperHeight 指定毫米单位

Puppeteer 的 page.pdf() 支持直接传入带单位的字符串，单位必须是 mm、in、px 或 cm —— 数字不带单位会被当作 px 处理，极易出错。

• paperWidth 和 paperHeight 必须同时设置，只设一个会 fallback 到 A4
• 值必须是字符串，如 "80mm"，写成 80 或 "80" 都无效
• 注意：Puppeteer 默认使用 print 媒体类型，确保 css 中的 @media print 或 @page 不冲突

await page.pdf({   path: 'ticket.pdf',   format: 'A4', // 此项与自定义尺寸互斥，必须删掉   width: '80mm',   height: '210mm',   margin: { top: '5mm', right: '2mm', bottom: '5mm', left: '2mm' } });

wkhtmltopdf 命令行里用 --page-width 和 --page-height

wkhtmltopdf 对单位更严格：只认 mm、cm、in、pt、px，且大小写敏感（MM 或 mm （尾空格）都会失败）。

• 不能混用 --page-width 和 --format A4，后者会覆盖前者
• 如果输出 PDF 尺寸仍不对，大概率是 HTML 内容撑开了页面——加 body { width: 100%; overflow: hidden; } 控制内容不溢出
• 中文内容建议加 --encoding utf-8，否则可能乱码或布局偏移

wkhtmltopdf    --page-width "80mm"    --page-height "210mm"    --margin-top "5mm"    --margin-right "2mm"    --margin-bottom "5mm"    --margin-left "2mm"    input.html output.pdf

CSS 的 @page 在多数工具中只是“建议”，不是强制

@page { size: 80mm 210mm; margin: 5mm 2mm; } 看似简洁，但实际支持度差：Puppeteer 从 v19+ 开始部分支持，wkhtmltopdf 0.12.6+ 仅支持命名尺寸（如 A4），WeasyPrint 支持最好但需显式启用 @page 解析。

立即学习“前端免费学习笔记（深入）”；

• 不要依赖 @page 单独控制尺寸，它常被命令行参数或 js API 设置覆盖
• 若用 WeasyPrint，需确认是否传了 --presentational-hints，否则部分样式（包括 @page）可能被忽略
• 移动端 viewport meta 标签对 PDF 生成完全无效，删掉也无影响

真正卡住的往往不是怎么写，而是没意识到：PDF 尺寸由生成工具决定，HTML 只负责内容排版；单位字符串拼错、参数冲突、内容溢出这三处，占了 80% 的“尺寸不对”问题。