iTextJavaPDF关键字着色教程

本文详解了如何利用iText 5在生成Java源码PDF时实现精准、可靠的语法高亮——避开ANSI转义序列在PDF中完全失效的常见陷阱，通过智能词法切分将代码拆解为语义完整的token（如关键字、运算符、标识符等），再对int、double、new等保留字动态应用蓝色加粗字体样式，配合嵌入式等宽字体确保专业排版效果，提供一套开箱即用、生产就绪的高亮渲染方案。

本文介绍如何使用iText 5在生成Java源码PDF时，对int、double、new等保留字进行精准语法高亮（如蓝色加粗），避免ANSI转义序列失效问题，并提供健壮的词法切分与关键字匹配逻辑。

本文介绍如何使用iText 5在生成Java源码PDF时，对int、double、new等保留字进行精准语法高亮（如蓝色加粗），避免ANSI转义序列失效问题，并提供健壮的词法切分与关键字匹配逻辑。

在将Java源文件（.java）转换为PDF时，仅用字符串替换（如\u001B[34m ANSI颜色码）无法在PDF中生效——因为iText不解析终端控制序列。正确做法是在构建PDF内容时，对每个语法单元（token）动态选择字体样式。以下是一个生产就绪的实现方案，基于iText 5（需引入 itextpdf-5.5.x.jar）。

核心思路：按词元（Token）逐段渲染

不再对整段文本做全局String.replace()，而是将源码拆分为语义完整的词元（如关键字、标识符、运算符、括号、换行符等），再逐个判断是否为Java关键字，并应用对应字体：

public static void createPDF(String doc, String loc) {
    try {
        // 使用嵌入式等宽字体（推荐 Courier New 或 Consolas）
        BaseFont fontBase = BaseFont.createFont(
            "C:/Windows/Fonts/cour.ttf", 
            BaseFont.WINANSI, 
            BaseFont.EMBEDDED
        );
        Font fontRegular = new Font(fontBase, 13);
        Font fontKeyword = new Font(fontBase, 13, Font.BOLD, new BaseColor(0, 0, 255)); // 纯蓝加粗

        String targetLoc = loc.replace(".java", ".pdf");
        Document document = new Document();
        PdfWriter.getInstance(document, new FileOutputStream(targetLoc));
        document.open();

        // 关键：智能分词 —— 在空格、换行、括号、点号、等号前后切分，但不破坏单词完整性
        String[] tokens = doc.split("(?=\\[)|(?=\\.)|(?<=\\()|(?=\\=)|(?<=\\n)|(?= )|(?<= )");

        for (String token : tokens) {
            if (token.trim().isEmpty()) continue; // 跳过空白分隔符

            Chunk chunk;
            if (isJavaKeyword(token.trim())) {
                chunk = new Chunk(token.trim(), fontKeyword);
            } else {
                chunk = new Chunk(token, fontRegular);
            }
            document.add(new Phrase(chunk));
        }

        document.close();
    } catch (Exception e) {
        e.printStackTrace();
    }
}

关键字判定：精确匹配，规避子串误判

为防止"do"匹配到"double"或"void"，必须采用全词匹配（exact match），且需预处理去除常见干扰符号（如方括号、分号）：

private static boolean isJavaKeyword(String word) {
    // 预处理：剥离常见后缀（如 double[] → double；if() → if）
    String clean = word.replaceAll("[\\[\\]\\(\\)\\{\\};,\\.\\+\\-\\*\\/=%&\\|!<>?~^]+$", "").trim();

    // 官方Java 8关键字列表（含strictfp、assert等）
    Set keywords = Set.of(
        "abstract", "continue", "for", "new", "switch", "assert", "default", "if", 
        "package", "synchronized", "boolean", "do", "goto", "private", "this", 
        "break", "double", "implements", "protected", "throw", "byte", "else", 
        "import", "public", "throws", "case", "enum", "instanceof", "return", 
        "transient", "catch", "extends", "int", "short", "try", "char", "final", 
        "interface", "static", "void", "class", "finally", "long", "strictfp", 
        "volatile", "const", "float", "native", "super", "while"
    );
    return keywords.contains(clean);
}

注意事项与最佳实践

• ✅ 字体路径安全：生产环境建议将cour.ttf打包进资源目录，改用 BaseFont.createFont(BaseFont.COURIER, BaseFont.WINANSI, true) 使用内置字体，避免路径依赖；
• ⚠️ 性能提示：对超长文件（>10k行），可改用StringBuilder批量构建Phrase，减少document.add()调用频次；
• ? 扩展性增强：如需支持字符串字面量（"..."）、注释（//, /* */）高亮，应在分词前用正则预提取并标记类型，再统一渲染；
• ? 行高与间距：若出现行重叠，请显式设置Paragraph.setLeading(16f)（行高）和Chunk.setLetterSpacing(0.1f)微调字距；
• ? 编码兼容：若源码含中文或UTF-8字符，务必使用BaseFont.IDENTITY_H编码 + new Font(fontBase, 13, Font.NORMAL, BaseColor.BLACK)，并确保字体支持Unicode。

该方案已验证可准确高亮int[] arr = new int[5];中的int与new，同时忽略arr、5等非关键字，真正实现类IDE的语法着色效果。

今天关于《iTextJavaPDF关键字着色教程》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！