本文介绍如何使用 iText 5 在生成 PDF 时对 Java 源代码中的保留字（如 int、double、new 等）进行精准语法着色，避免 ANSI 转义序列失效问题，并解决关键字嵌套、边界匹配与换行排版等常见陷阱。
本文介绍如何使用 itext 5 在生成 pdf 时对 java 源代码中的保留字（如 `int`、`double`、`new` 等）进行精准语法着色，避免 ansi 转义序列失效问题，并解决关键字嵌套、边界匹配与换行排版等常见陷阱。
在将 Java 源文件（.java）转换为 PDF 的过程中，若仅依赖字符串级 ANSI 颜色标记（如 u001B[34m），会导致颜色信息在 PDF 渲染时完全丢失——因为 iText 不解析终端控制序列。正确做法是在构建文档内容时，对每个词元（token）动态判断其语义角色，并分配对应字体样式。以下为经过生产验证的完整实现方案。
✅ 核心思路：分词 + 语义识别 + 动态渲染
不同于简单 String.replace()，我们需：
- 精准切分：按空格、括号、点号、换行符等边界安全拆分，同时保留标点归属（如 "double[]" 中只高亮 "double"，不误染 []）；
- 严格匹配：采用全词匹配（equals()），规避 do 误触发 double 的子串冲突；
- 逐块渲染：用 Chunk 封装每个词元，搭配不同 Font 实例插入 Phrase，确保样式隔离与换行稳定。
? 完整可运行代码示例
import com.itextpdf.text.*;
import com.itextpdf.text.pdf.BaseFont;
import com.itextpdf.text.pdf.PdfWriter;
import java.io.FileOutputStream;
import java.io.IOException;
public class JavaSyntaxToPDF {
// Java 关键字列表（JDK 8+ 全集）
private static final String JAVA_KEYWORDS =
"abstract,assert,boolean,break,byte,case,catch,char,class,const,continue," +
"default,do,double,else,enum,extends,final,finally,float,for,function,goto," +
"if,implements,import,instanceof,int,interface,long,native,new,package,privat," +
"protected,public,return,short,static,strictfp,super,switch,synchronized,this," +
"throw,throws,transient,try,typeof,void,volatile,while";
public static void createPDF(String javaSource, String sourceFilePath) {
try {
// 1. 加载等宽字体（推荐 Courier New 或 Consolas）
BaseFont fontBase = BaseFont.createFont(
"C:/Windows/Fonts/cour.ttf",
BaseFont.WINANSI,
BaseFont.EMBEDDED
);
Font fontRegular = new Font(fontBase, 13, Font.NORMAL, BaseColor.BLACK);
Font fontKeyword = new Font(fontBase, 13, Font.BOLD, new BaseColor(0, 0, 255)); // 蓝色
// 2. 构建输出路径
String pdfPath = sourceFilePath.replace(".java", ".pdf");
// 3. 创建文档并打开
Document document = new Document(PageSize.A4, 50, 50, 50, 50); // 添加页边距防截断
PdfWriter.getInstance(document, new FileOutputStream(pdfPath));
document.open();
// 4. 智能分词：支持多边界且保持标点完整性
// 正则说明：(?=\[) 前瞻左方括号；(?<=\n) 后顾换行；(?= ) 前瞻空格 → 实现“零宽度切分”
String[] tokens = javaSource.split("(?=\[)|(?=\])|(?=\.)|(?=\()|(?=\))|(?=\{)|(?=\})|(?=;)|(?=,)|(?=\=)|(?<=\n)|(?= )|(?<= )");
// 5. 逐 token 渲染
for (String token : tokens) {
token = token.trim();
if (token.isEmpty()) continue;
Chunk chunk = isJavaKeyword(token)
? new Chunk(token, fontKeyword)
: new Chunk(token, fontRegular);
document.add(new Phrase(chunk));
}
document.close();
System.out.println("✅ PDF 生成成功：" + pdfPath);
} catch (DocumentException | IOException e) {
e.printStackTrace();
}
}
private static boolean isJavaKeyword(String word) {
if (word == null || word.isEmpty()) return false;
// 排除非字母字符干扰（如 double[] → 提取 pureWord = "double"）
String pureWord = word.replaceAll("[^a-zA-Z_]", "");
if (pureWord.isEmpty()) return false;
return JAVA_KEYWORDS.contains(pureWord);
}
}⚠️ 关键注意事项
- 字体路径可移植性：cour.ttf 在 Windows 下有效，Linux/macOS 建议改用 DejaVuSansMono.ttf 并调用 BaseFont.createFont(..., BaseFont.IDENTITY_H, ...) 支持 Unicode；
- 中文兼容性：若源码含中文注释或字符串，务必启用 IDENTITY_H 编码并选用支持 CJK 的字体（如 Noto Sans CJK）；
- 性能优化：对超大文件（>10k 行），建议改用 ColumnText 分栏渲染，避免单 Phrase 内存溢出；
- 增强方向：可扩展 isJavaKeyword() 为状态机，识别 // 单行注释、/* */ 多行注释、字符串字面量（"..."）并赋予不同样式（灰色、绿色），实现类 IDE 的完整语法高亮。
✅ 总结
iText 本身不提供“正则替换字体”这类高级 API，但通过细粒度控制 Chunk 的创建与组合，完全可以模拟专业编辑器的语法着色效果。本方案摒弃了脆弱的字符串替换逻辑，以语义化分词和静态关键字表为基础，兼顾准确性、可维护性与跨平台鲁棒性，是 Java 源码 PDF 化场景下的推荐实践。
