iText 7 支持匈牙利语特殊字符显示方法

在 iText 7 中正确渲染匈牙利语特殊字符（如ő、ű、Ő、Ű）的关键在于摒弃默认的UTF-8编码和StandardFonts，转而使用支持东欧语言的CP1250编码（Windows Latin-2标准）、本地TrueType字体文件（如arial.ttf）并强制嵌入字体——这一组合精准覆盖U+0151、U+0171等码位，彻底解决空白或方块乱码问题，同时兼顾轻量性与跨平台可靠性，是生成符合匈牙利语排版规范PDF的最简高效方案。

在 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。

今天关于《iText 7 支持匈牙利语特殊字符显示方法》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！