iText 7创建带嵌入字体的可编辑字段无法显示输入内容，如何解决？

我之前在处理iText表单字段时踩过完全一样的坑——未嵌入字体时输入内容正常显示，一嵌入字体就看不到输入的内容。结合你的代码和常见的排查方向，给你几个针对性的解决方案：

1. 确保字体嵌入的参数和编码设置正确 #

你遇到的问题大概率是字体创建时没有正确启用嵌入，或者编码不匹配导致的。iText中创建嵌入字体时，需要明确指定嵌入参数和适合的编码（尤其是处理非ASCII字符时）：

比如替换你的字体创建代码为：

// 以TrueType字体为例，第三个参数true表示启用嵌入，IDENTITY_H支持多语言字符
PdfFont fieldFont = PdfFontFactory.createFont("path/to/your/font.ttf", PdfEncodings.IDENTITY_H, true);

如果是Type1字体，也要确保嵌入参数设置为true，并且编码适配你的输入内容。

2. 修正表单字段的字体绑定逻辑 #

有时候即使字体嵌入了，表单字段没有正确关联到嵌入字体的完整属性。可以尝试显式设置字段的字体字典，确保嵌入的字体被正确引用：

PdfTextFormField myPdfField = PdfTextFormField.CreateText(pdfDoc, textBoxRect, sAssignedName);
// 先设置字体，再配置其他属性
myPdfField.SetFont(fieldFont);
// 额外确保字段的默认外观（DA）正确引用嵌入字体
myPdfField.SetDefaultAppearance("/" + fieldFont.GetFontProgram().GetFontNames().GetFontName() + " 12 Tf 0 g");
myPdfField.SetVisibility(PdfFormField.VISIBLE);

这里的关键是SetDefaultAppearance，它会明确告诉PDF阅读器使用嵌入的字体来渲染输入的内容，避免阅读器 fallback 到系统字体。

3. 排查字体子集化的问题 #

如果你的字体是子集嵌入（iText默认可能会子集化），有时候会出现表单字段无法引用子集字体的情况。可以尝试禁用子集化，强制嵌入完整字体：

// 创建字体时禁用子集化，第四个参数false表示不子集化
PdfFont fieldFont = PdfFontFactory.createFont("path/to/your/font.ttf", PdfEncodings.IDENTITY_H, true, false);

虽然完整字体会增大PDF体积，但能排除子集化导致的字段字体引用问题。

4. 用Adobe Reader测试验证 #

有些轻量PDF阅读器对表单嵌入字体的支持不好，建议用Adobe Reader打开测试——如果在Adobe Reader里能正常显示，说明是阅读器兼容性问题；如果还是不行，那就是代码层面的字体设置问题。

内容的提问来源于stack exchange，提问作者Mike Amos