iTextSharp不直接支持XML转PDF，因其是PDF生成库而非XML渲染引擎，需手动解析XML并映射样式布局，或使用已废弃的XMLWorker（需配字体、XHTML规范、避免大文件）。
为什么 iTextSharp 不直接支持 XML 转 PDF
iTextSharp 是一个 PDF 生成库，不是 XML 渲染引擎。它不解析 HTML 或 XML 标签语义，也不会自动把 <p></p> 变成段落、<h1></h1> 变成大标题。你传给它的 XML 字符串，它只会当纯文本处理——除非你自己写逻辑去遍历节点、映射样式、计算布局。
常见错误现象：document.Add(new Paragraph(xmlString)) 结果 PDF 里全是未解析的尖括号标签；或者用 XMLWorkerHelper.ParseXHtml() 却报 NullReferenceException，因为没配好字体或 CSS。
- 必须手动加载字体（尤其是中文），否则
XMLWorker渲染时会静默失败 -
XMLWorker已在 iTextSharp 5.x 后期被标记为废弃，官方不推荐新项目使用 - XML 必须是格式良好（well-formed）的 XHTML 片段，不能含自定义标签或命名空间
用 XMLWorker 渲染简单 XHTML 的最小可行步骤
如果你只是要把一份结构清晰、不含 JS/CSS 复杂逻辑的 XHTML 转 PDF（比如后台导出报表页），可以走 XMLWorker 这条路，但得踩准几个点：
- 引用
iTextSharp.xmlworkerNuGet 包（注意版本需与iTextSharp5.5.x 匹配） - 创建
FontFactory.RegisterDirectory()或显式注册中文字体文件（如"simhei.ttf"），否则中文全空白 - 用
CssFilesImpl加载基础 CSS，至少定义body { font-family: "SimHei" } - 调用
XMLWorkerHelper.ParseXHtml(writer, document, new StringReader(xhtml), null, Encoding.UTF8, fontProvider)
示例关键片段：
var fontProvider = new XMLWorkerFontProvider("fonts/simhei.ttf");
var css = @"body { font-family: 'SimHei'; font-size: 12px; }
h1 { color: #333; }";
var cssBytes = Encoding.UTF8.GetBytes(css);
using (var ms = new MemoryStream(cssBytes))
{
XMLWorkerHelper.GetInstance().ParseXHtml(writer, document,
new StringReader(xhtml), ms, Encoding.UTF8, fontProvider);
}
XmlDocument + 手动遍历比 XMLWorker 更可控
当你 XML 里有业务定制标签（比如 <invoice-number></invoice-number>、<payment-due></payment-due>），或者需要动态插入表格、页眉页脚、水印时，硬套 XMLWorker 反而绕远路。直接用 XmlDocument 解析，再按节点类型调用 document.Add() 对应元素更稳。
-
<title></title>→new Paragraph(text).SetAlignment(Element.ALIGN_CENTER) <table rows="3"> → 实例化 <code>PdfPTable(3)，逐行添加PdfPCell-
<image src="logo.png"></image>→ 用iTextSharp.text.Image.GetInstance(path)，注意路径必须是服务端可读的绝对路径 - 避免在循环中反复调用
document.NewPage()，容易导致空白页——检查是否误在根节点外触发了分页 - 单次渲染不要超过 500 行 XHTML；超长内容拆成多个
document实例分批写入 - 禁用
XMLWorker的 CSS 解析（传null替代CssFilesImpl），改用内联 style 控制基础样式 - 字体只注册实际用到的字重（比如只要常规体，就别把 bold/italic 全塞进去）
- 调试时加
try/catch捕获DocumentException，里面常含真实失败原因，比如 “Could not resolve font ‘SimHei’”
生成速度慢、内存溢出？别让 XMLWorker 做它不该做的事
大 XML（>2MB）+ 复杂 CSS + 多字体嵌入，会让 XMLWorker 在解析阶段就卡住或抛 OutOfMemoryException。这不是配置问题，是设计边界。
真正难的不是怎么转，是怎么界定 XML 的职责边界：它该是数据容器，不是排版指令集。一旦开始往 XML 里塞 margin-top="20px" 或 font-size="14pt"，你就已经站在了维护地狱门口。
