如何使用C#（iTextSharp）合并PDF并确保符合ADA合规性？

要让合并后的PDF通过Adobe Acrobat Pro的ADA合规检查，得重点处理标签结构、元数据、可访问属性这些核心要求，结合iTextSharp的操作调整如下：

• 强制开启Tagged PDF
  这是ADA合规的基础，Acrobat依赖标签识别文档结构。代码里必须加上：

Document document = new Document();
PdfWriter writer = PdfWriter.GetInstance(document, new FileStream("输出路径", FileMode.Create));
writer.SetTagged(); // 启用标签支持
writer.ViewerPreferences = PdfWriter.DisplayDocTitle; // 让阅读器优先显示文档标题
document.Open();

• 完善文档元数据
  给文档加标题、作者等基础信息，这是合规检查的必过项：

document.AddTitle("合并后的合规PDF文档");
document.AddAuthor("你的名称");
document.AddSubject("符合ADA标准的合并文档");

• 合并时保留/补全可访问属性
  如果是合并现有PDF：

  • 用PdfSmartCopy替代普通PdfCopy，尽量保留源文档的标签结构
  • 对没标签的源PDF，要手动给文本、图片补全属性：
    • 图片必须加替代文本：

    Image img = Image.GetInstance("图片路径");
    img.Alt = "这里写图片的描述文本，要准确反映图片内容";
    document.Add(img);
    

    • 文本要用可嵌入、可提取的字体，避免用图片代替文本

• 构建逻辑结构层级
  用PdfStructureElement定义标题、段落等层级，方便屏幕阅读器识别：

PdfStructureElement root = writer.RootOutline;
// 一级标题
PdfStructureElement h1 = new PdfStructureElement(root, PdfName.H1);
h1.Put(PdfName.T, new PdfString("核心内容标题"));
document.Add(new Paragraph("核心内容标题"));

• 颜色与字体检查

  • 文本和背景对比度要符合WCAG 2.1标准（至少4.5:1），别用浅灰配白底这种低对比组合
  • 确保字体嵌入到PDF里，避免阅读器用替代字体导致结构混乱

• 生成后验证步骤
  用Adobe Acrobat Pro的「工具 > 可访问性 > 完整检查」跑一遍，常见问题：

  • 缺失标签结构：回到代码里确认SetTagged()已开启
  • 图片无替代文本：补全img.Alt属性
  • 字体未嵌入：调整字体加载代码，确保嵌入完整字体

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