使用iText PDF添加Unicode表情符号时遇到问题求助

我帮你搞定这个iText 5.5.13里添加Unicode表情符号的问题！你现在的代码只定义了带表情的字符串，但核心的PDF生成和字体处理步骤没做全，所以表情符号肯定显示不出来。下面是修正后的完整解决方案：

关键问题分析 #

你的代码有两个核心问题：

• 缺少完整的PDF生成流程，没有将文本实际写入到PDF文档中；
• 没有正确加载支持Unicode表情符号的字体，也没有在写入文本时指定该字体。

修正后的完整代码 #

import com.itextpdf.text.Document;
import com.itextpdf.text.DocumentException;
import com.itextpdf.text.Font;
import com.itextpdf.text.Paragraph;
import com.itextpdf.text.pdf.BaseFont;
import com.itextpdf.text.pdf.PdfWriter;

import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;

public class MathSymbols {
    public static final String DEST = "EXAMPLE.pdf";
    // 请根据你的项目结构调整字体文件路径，确保文件存在
    public static final String FONT = "src/main/resources/fonts/arialuni.ttf";
    public static String TEXT;

    public static void main(String[] args) throws IOException, DocumentException {
        // 正确拼接表情符号：char数组要转成字符串，避免显示数组对象的toString结果
        TEXT = "this " + new String(Character.toChars(0x1F600)) + " string \uD83D\uDE00 contains \ud83d\ude00 special \u2609 character...";

        // 初始化PDF文档
        Document document = new Document();
        PdfWriter.getInstance(document, new FileOutputStream(new File(DEST)));
        document.open();

        // 加载支持Unicode的字体，关键参数说明：
        // - BaseFont.IDENTITY_H：支持宽字符（如表情符号）的Unicode编码
        // - BaseFont.EMBEDDED：将字体嵌入PDF，确保其他设备也能正常显示
        BaseFont baseFont = BaseFont.createFont(FONT, BaseFont.IDENTITY_H, BaseFont.EMBEDDED);
        Font unicodeFont = new Font(baseFont, 12);

        // 使用指定字体添加文本段落
        document.add(new Paragraph(TEXT, unicodeFont));

        document.close();
        System.out.println("PDF生成完成，路径：" + DEST);
    }
}

核心注意事项 #

• 字体选择与路径：必须使用支持完整Unicode字符集的字体（比如Arial Unicode MS），并且确保字体文件路径正确。如果是Maven项目，通常把字体放在src/main/resources/fonts目录下；
• 编码设置：一定要用BaseFont.IDENTITY_H作为编码，这是iText 5中处理包含表情符号等宽字符的正确编码，默认编码无法解析这些字符；
• 字体嵌入：设置BaseFont.EMBEDDED参数，避免在没有安装该字体的设备上出现乱码或空白；
• 字符拼接：Character.toChars()返回的是char数组，必须用new String()转换成字符串后再拼接，否则会显示类似[C@xxxxxx的错误内容。

内容的提问来源于stack exchange，提问作者Ignazio Cricelli