不声明<meta charset="UTF-8">会导致浏览器和转换工具按默认编码（如ISO-8859-1或系统locale）解析，中文、日文、emoji显示为问号或方块；wkhtmltopdf、weasyprint等需显式指定UTF-8编码，pdfkit更必须传encoding="UTF-8"参数，否则即使文件为UTF-8也会乱码。
HTML文件里没写<meta charset="UTF-8">会怎样
不声明编码，浏览器和转换工具会按默认编码（通常是ISO-8859-1或系统 locale）解析 HTML，中文、日文、emoji 全部变问号或方块。wkhtmltopdf、weasyprint、pd4ml 等工具在读取本地文件时不会自动探测 UTF-8，必须显式指定；html2canvas 虽在前端运行，但若页面本身未声明编码，DOM 解析阶段就已乱码，后续截图也是错的。
pdfkit.from_file() 必须传 encoding 参数
Python 的 pdfkit 库不从 HTML 文件头读取 <meta>，它只认你传进去的 encoding 选项。即使 HTML 文件保存为 UTF-8，漏掉这个参数，中文照样乱码。
正确做法：
- 确保 HTML 文件用 UTF-8 无 BOM 编码保存（编辑器里可查）
- 调用时显式传参：
pdfkit.from_file("page.html", "out.pdf", options={"encoding": "UTF-8"}) - 如果 HTML 是通过 HTTP 获取的（
from_url），也要传同样参数，否则服务器返回头没带Content-Type: text/html; charset=utf-8就崩
服务端生成 PDF 时，pd4ml 和 weasyprint 的编码处理差异
pd4ml（Java）需在 Java 代码中设置：pd4ml.setPageWidth(800); pd4ml.setHtmlWidth(800); pd4ml.setDocEncoding("UTF-8"); —— 它不看 HTML 里的 <meta>，只信这个 API 调用。
立即学习“前端免费学习笔记（深入）”；
weasyprint（Python）更友好些：它会先尝试读取 HTML 中的 <meta charset>，但前提是该标签在 <head> 最前面、没被 JS 动态插入。保险起见仍建议同时做两件事：
- HTML 头部加
<meta charset="UTF-8"> - Python 调用时加
weasyprint.HTML(string=html_str).write_pdf(target, encoding='utf8')
浏览器打印导出 PDF 为什么有时不乱码，有时乱
因为浏览器打印功能本身不依赖 HTML 的 <meta charset>，它靠的是当前文档的 DOM 编码状态。如果页面是通过 fetch + innerHTML 注入的 HTML 字符串，而没指定 response.text() 的解码方式，或者后端响应头没带 charset=utf-8，那注入后的 DOM 已经是乱码，打印出来的 PDF 自然也乱。
验证方法：打开开发者工具 → Elements 面板，直接看中文是否正常显示。不是“看起来像”，而是右键「查看网页源代码」里也得是原样中文——否则任何 PDF 导出流程都救不回来。
