iText7中文字体使用教程：阿里巴巴普惠体、思源黑体、思源宋体

2026-02-06 05:47:53作者：袁立春Spencer

项目地址：https://gitcode.com/gh_mirrors/it/itext7-chinese-font

在Java PDF生成领域，iText7是最常用的开源库之一。然而在使用过程中，许多开发者都会遇到中文字体显示的问题。itext7-chinese-font项目专门解决了这一痛点，提供了阿里巴巴普惠体、思源黑体、思源宋体等优质中文字体的完整集成方案。

环境准备

首先需要在项目中引入iText7的依赖。该项目使用Maven进行管理，pom.xml文件中已经配置了所需的依赖项：

<dependency>
    <groupId>com.itextpdf</groupId>
    <artifactId>itext7-core</artifactId>
    <version>7.2.1</version>
    <type>pom</type>
</dependency>

<dependency>
    <groupId>com.itextpdf</groupId>
    <artifactId>html2pdf</artifactId>
    <version>4.0.1</version>
</dependency>

核心实现原理

项目通过FontProvider机制来管理字体文件，核心代码位于src/main/java/com/starxg/itext7chinesefont/IText7ChineseFont.java。主要实现了三种字体的动态加载：

阿里巴巴普惠体集成

提供Light和Bold两种字重：AlibabaPuHuiTi-2-45-Light.ttf和AlibabaPuHuiTi-2-85-Bold.ttf

思源黑体集成

包含ExtraLight和Medium两种样式：SourceHanSansSC-ExtraLight.otf和SourceHanSansSC-Medium.otf

思源宋体集成

同样提供ExtraLight和Medium两种样式：SourceHanSerifSC-ExtraLight.otf和SourceHanSerifSC-Medium.otf

使用示例

项目的主类展示了如何使用这些中文字体生成PDF：

public class IText7ChineseFont {
    public static void main(String[] args) throws Exception {
        // 读取HTML模板
        final InputStream is = IText7ChineseFont.class.getResourceAsStream("/Template.html");
        final String html = IOUtils.toString(is, StandardCharsets.UTF_8);
        
        // 使用不同字体生成PDF
        html2pdf("alibaba", html, getAlibabaFontDirectory());
        html2pdf("source sans", html, getSourceHanSansFontDirectory());
        html2pdf("source serif", html, getSourceHanSerifFontDirectory());
    }
}