——從字體原理到工程落地的完整實踐指南

一、問題背景：為什么“生僻字”在 PDF 中總是出問題？

在 Java 項目中使用 iText / OpenPDF / Flying Saucer 生成 PDF，是非常常見的需求，典型場景包括：

• 合同 / 協(xié)議生成
• 電子檔案
• 報表導出
• 存證類文件

但一旦涉及中文生僻字（如姓名、地名、少數(shù)民族用字、古籍用字），就很容易出現(xiàn)以下問題：

• PDF 中顯示為 □
• 直接空白
• 只有數(shù)字、符號、序號，中文正文消失
• 本機正常，換一臺機器就亂碼

這些問題并不是 iText 的 bug，而是對 PDF 字體機制 + 中文字符集 理解不足導致的。

二、核心結(jié)論先行（非常重要）

Java 生成 PDF 要支持中文生僻字，本質(zhì)上只取決于三件事：

1. 字體是否真正包含該字符（Glyph 是否存在）
2. PDF 是否使用了該字體（CSS / font-family）
3. 字體是否隨 PDF 一起嵌入（EMBEDDED）

只要其中任意一個不滿足，生僻字一定失敗。

三、為什么宋體（SimSun）無法支持生僻字？

1. SimSun 的歷史定位

SimSun.ttc（宋體）是一個非常早期的中文字庫，主要覆蓋：

• GB2312 / GBK
• 常用漢字

但它不包含：

• CJK 擴展區(qū) A / B / C / D / E / F
• 大量現(xiàn)代姓名用字（如：??、??）
• 古籍、少數(shù)民族漢字

2. 結(jié)論

宋體不是“壞字體”，而是“時代局限字體”
它從設(shè)計之初就沒打算覆蓋 Unicode 全中文字符集。

因此：

• Word 里能顯示 ≠ PDF 一定能顯示
• 系統(tǒng)里有 ≠ 所有人機器都有

四、真正支持生僻字的字體：Noto / 思源系列

1. 推薦字體

在 Java PDF 場景中，強烈推薦使用靜態(tài)版本的 Noto 字體：

NotoSansCJKsc-Regular.otf

特點：

• 覆蓋幾乎全部 Unicode 中文字符
• 支持 CJK 擴展區(qū)
• 免費可商用（SIL OFL）
• iText / Flying Saucer 完全支持

五、常見字體后綴解析（避免踩坑）

特別警告：Variable Font（VF）

NotoSansCJKsc-VF.ttf

iText / Flying Saucer 完全不支持，使用后常見現(xiàn)象是：

• 只有數(shù)字、符號
• 中文正文全部消失
• 不報錯，非常迷惑

六、Java 端正確的字體加載方式

1. 必須使用IDENTITY_H

BaseFont.IDENTITY_H

作用：

告訴 PDF 使用 Unicode 編碼，而不是單字節(jié)編碼。

2. 強烈建議使用EMBEDDED

BaseFont.EMBEDDED

為什么？

• NOT_EMBEDDED 只是“引用字體名”
• 是否能顯示，完全依賴打開 PDF 的環(huán)境
• 換機器 / Linux / Docker 必定翻車

你現(xiàn)在能顯示，只是環(huán)境“碰巧”有該字體

3. 標準代碼示例

ITextFontResolver fontResolver = renderer.getFontResolver();
fontResolver.addFont(
    "NotoSansCJKsc-Regular.otf",
    BaseFont.IDENTITY_H,
    BaseFont.EMBEDDED
);

七、最容易被忽略的一點：HTML / CSS 才是真正的“使用字體”

1. 一個常見誤區(qū)

“我在 Java 里 addFont 了，為什么中文還不顯示？”

原因是：

addFont 只是“注冊”，不是“使用”

2. 必須在模板中顯式指定font-family

<style>
body {
    font-family: "Noto Sans CJK SC";
    font-size: 12pt;
}
</style>

關(guān)鍵點：

• 使用 字體內(nèi)部 family 名稱
• 不是文件名
• 建議寫在 body，讓所有元素繼承

如果不寫這一步，F(xiàn)lying Saucer 會退回到內(nèi)置 Latin 字體，中文直接丟失。

八、為什么換成 Noto 后，版式可能發(fā)生變化？

這是一個正常且不可避免的現(xiàn)象。

原因：

• 不同字體的字寬不同
• 行高（ascent / descent）不同
• 筆畫粗細不同

因此可能導致：

• 換行點變化
• 表格溢出
• 分頁變化

九、工程級應對方案（必須知道）

1. 固定行高

body {
    line-height: 1.4;
}

2. 表格列寬避免“卡死”

優(yōu)先：

width: 25%;

避免：

width: 80px;

3. 字號微調(diào)

經(jīng)驗值：

十、生僻字驗證（上線前必做）

在模板中加入測試文本：

龘 麤 鱻 ?? ??

全部可見，才算真正支持生僻字。

十一、最終推薦的“標準方案”

生產(chǎn)級、穩(wěn)定、可遷移的最佳實踐

• 字體：NotoSansCJKsc-Regular.otf
• 編碼：IDENTITY_H
• 嵌入：EMBEDDED
• CSS：body 全局 font-family
• 行高：顯式設(shè)置
• 表格：避免極限寬度

十二、一句話總結(jié)

Java 生成 PDF 的生僻字問題，從來不是“渲染問題”，

而是“字體工程問題”。

理解了 字體覆蓋范圍 + PDF 字體嵌入機制 + CSS 使用方式，

這個問題可以一次性、永久性解決。

到此這篇關(guān)于Java生成PDF時該如何正確支持中文生僻字的文章就介紹到這了,更多相關(guān)Java生成PDF支持中文生僻字內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評論