
在 itext 7 中使用系统字体(如 arial 或 times new roman)渲染匈牙利语等东欧语言的 unicode 字符时,若直接指定 `pdfencodings.utf8` 仍显示为空白,应改用兼容的 windows 字符编码 `cp1250` 并嵌入字体,才能正确显示 ő、ű、Ő、Ű 等字符。
iText 7 默认的 StandardFonts(如 TIMES_BOLD)仅包含基础 Latin-1 字符集(ISO-8859-1),不支持扩展拉丁字符(如带双重重音的 ő/ű)。即使这些字符在操作系统字体中存在,若未显式指定兼容编码并嵌入字体,PDF 渲染引擎将无法映射字形,最终输出为空白或方块。
✅ 正确做法是:使用本地 TrueType 字体文件(如 arial.ttf 或 times.ttf),配合 CP1250 编码(Windows Latin-2,专为中/东欧语言设计),并启用字体嵌入(true 参数):
// ✅ 推荐:使用 CP1250 编码 + 嵌入字体(关键!)
PdfFont font = PdfFontFactory.createFont(
"C:/Windows/Fonts/arial.ttf", // Windows 路径;Linux/macOS 请替换为 /usr/share/fonts/truetype/dejavu/DejaVuSans.ttf 等
PdfEncodings.CP1250, // 不是 UTF8!CP1250 显式支持 ő, ű, Ő, Ű
true // 必须设为 true,确保字体嵌入 PDF,避免目标环境缺失字体
);⚠️ 注意事项:
- PdfEncodings.UTF8 在 iText 7 中不适用于字体编码映射——它仅用于字符串解码,而字体本身需通过 createFont(..., encoding, embedded) 的 encoding 参数声明其字符集范围。CP1250 是 Windows 下匈牙利语、波兰语、捷克语等的标准编码,原生覆盖 U+0151 (ő)、U+0171 (ű) 等码位。
- 若使用 StandardFonts.TIMES_BOLD,其底层为 Type 1 字体,不支持 Unicode 扩展字符,且无法指定编码,故必须弃用,改用本地 TTF 文件。
- 字体路径需真实存在,且应用有读取权限;生产环境建议将字体文件打包进 resources,用 getClass().getResourceAsStream("/fonts/arial.ttf") 加载,提升可移植性。
- 中文、日文等其他 Unicode 字符需改用 Identity-H 编码(配合 Noto Sans CJK 等字体),但 CP1250 对匈牙利语已足够且更轻量。
最后,整合到你的 addCenteredParagraph 方法中:
private static void addCenteredParagraph(Document document, float width, String text) {
PdfFont font = null;
try {
// 使用 CP1250 + 嵌入字体(推荐 Arial 或 Times New Roman 的 .ttf)
font = PdfFontFactory.createFont("C:/Windows/Fonts/arial.ttf", PdfEncodings.CP1250, true);
} catch (IOException e) {
LOGGER.error("Failed to load font with CP1250 encoding", e);
return;
}
List tabStops = new ArrayList<>();
tabStops.add(new TabStop(width / 2, TabAlignment.CENTER));
tabStops.add(new TabStop(width, TabAlignment.LEFT));
Paragraph p = new Paragraph()
.addTabStops(tabStops)
.setFontSize(14)
.setFont(font)
.setTextAlignment(TextAlignment.CENTER); // 更直观的居中方式(替代 Tab)
p.add(text); // 直接添加文本,无需手动加 Tab(除非需复杂对齐)
document.add(p);
} ✅ 总结:解决 ő/ű 显示问题的核心不是“UTF-8”,而是选择支持该字符集的字体 + 匹配的编码(CP1250)+ 强制嵌入。跳过 StandardFonts,拥抱本地 TTF 与 CP1250,即可稳定输出符合匈牙利语排版规范的 PDF。










