关于wkPDF生成文件中泰文字符显示为黑块的技术咨询

我之前在处理多语言PDF生成时，也踩过wkPDF对泰文这类非拉丁字符显示的坑，你遇到的黑块问题，基本跑不开字体嵌入、编码或者渲染配置这几个方向，给你整理几个实用的排查和解决方法：

• 强制嵌入支持泰文的字体：wkPDF默认不会自动嵌入所有系统字体，邮件客户端打开PDF时，如果本地没有对应的泰文字体，就会用黑块替代。你需要指定一款支持泰文的字体（比如TH Sarabun New、Arial Unicode MS，或者你系统里已安装的泰文字体），并在生成时开启字体嵌入。
  比如命令行调用时可以加这些参数：

  wkhtmltopdf --encoding utf-8 --font-name "TH Sarabun New" --embed-fonts --no-outline input.html output.pdf
  

  如果是用代码集成（比如PHP的wkpdf扩展），记得在配置项里设置字体路径和开启嵌入选项。

• 确认源内容的编码正确性：先检查你的输入HTML是否是UTF-8编码，并且在页面头部明确声明：

  <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  

  泰文字符如果在转码过程中出现乱码，生成PDF后就会变成黑块，所以源内容的编码一定要准确。

• 适配邮件客户端的PDF渲染特性：有些邮件客户端（比如Outlook）对PDF的字体兼容性要求很高，即使本地PDF阅读器显示正常，邮件里也可能出问题。这时候可以试试：

  • 改用更通用的多语言字体，比如Arial Unicode MS，这款字体被大多数系统支持，嵌入后兼容性更好
  • 调整wkPDF的渲染参数，比如关闭压缩或者智能收缩：--no-pdf-compression、--disable-smart-shrinking

• 升级wkPDF到最新稳定版：旧版本的wkPDF对非拉丁字符的渲染存在一些已知bug，升级到最新版往往能解决不少兼容性问题。

最后，先确认你要显示的泰文“ซอย สามเสน”在源HTML里是正常显示的，没有被转义或者损坏，再按上面的步骤逐一排查，应该能解决黑块问题。

内容的提问来源于stack exchange，提问作者Dilip Kumar Madhesiya