在 iText 7 中，getWidthPoint() 已被移除，需通过 BaseFont.getWidthPoint() 或 PdfFont.getWidth() 配合字体实例和字号显式计算文本宽度，不再支持链式调用后直接获取。
在 itext 7 中，`getwidthpoint()` 已被移除，需通过 `basefont.getwidthpoint()` 或 `pdffont.getwidth()` 配合字体实例和字号显式计算文本宽度，不再支持链式调用后直接获取。
在从 iText 5 升级到 iText 7 的过程中，许多开发者会遇到文本宽度计算失效的问题。例如，以下 iText 5 代码可直接返回宽度（单位：点）：
new Chunk(" TEST ", FONT_BOLD).getWidthPoint();但在 iText 7 中，类似链式构建的 Text 对象（如 new Text(" TEST ").setFont(...).setFontSize(...)）不提供 getWidthPoint() 或等效的宽度访问器；调用 .getStrokeWidth() 等方法返回 null 是预期行为——因为 Text 是布局元素，其最终渲染宽度取决于上下文（如容器宽度、换行、对齐等），并非静态可预知值。
✅ 正确替代方案是：使用字体对象本身提供的宽度计算方法，分为两类：
1. 使用 PdfFont.getWidth()（推荐，面向现代 API）
适用于已加载的 PdfFont 实例（如通过 PdfFontFactory.createFont() 获取）：
PdfFont font = PdfFontFactory.createFont(StandardFonts.HELVETICA_BOLD); float fontSize = 12f; String text = " TEST "; float widthInPoints = font.getWidth(text, fontSize); // 返回精确字形宽度（含字距调整）
✅ 优势：支持 TrueType、OpenType、嵌入字体及 Unicode 处理；自动应用字体内置的字宽表（glyph width table），结果更准确。
2. 使用 BaseFont.getWidthPoint()（兼容旧逻辑，仅限 Type1/TrueType 基础字体）
若你仍使用 BaseFont（如 BaseFont.createFont(...)），可调用：
BaseFont baseFont = BaseFont.createFont(StandardFonts.HELVETICA_BOLD, BaseFont.WINANSI, false);
float widthInPoints = baseFont.getWidthPoint(" TEST ", 12f);⚠️ 注意：BaseFont 在 iText 7 中属于遗留层，不推荐新项目使用；它不支持 OpenType 字体或高级排版特性，且部分构造方式已被弃用。
? 关键注意事项
- 不可对 Text、Paragraph 等布局对象调用宽度方法：它们的尺寸由 Document 渲染流程动态决定，需通过 LayoutManager 获取实际布局结果（适用于复杂场景，但开销大，非必要不推荐）。
- 空格与不可见字符计入宽度：" TEST " 中首尾空格会被计算，如需净内容宽度，建议先 trim() 再测量。
- 字号单位始终为“点（pt）”：与 PDF 规范一致，1 pt = 1/72 英寸，无需额外换算。
- 性能提示：PdfFont.getWidth() 是轻量级纯计算，可安全用于循环或高频调用。
✅ 总结
iText 7 将文本度量职责明确交还给字体对象，体现了“关注点分离”的设计原则。要获取字符串的 PDF 渲染宽度，请务必：
- 持有有效的 PdfFont 实例；
- 调用 font.getWidth(text, fontSize)；
- 避免依赖布局类的中间状态。
这一变更虽需适配，却显著提升了精度与可预测性——尤其在多语言、变体字体或自定义字距场景下，成为构建专业 PDF 排版功能的可靠基础。
