如何在 C# (.NET) 中删除 PDF 和文档的批注

想象一下：您正在开发文档管理系统，用户抱怨 PDF 中充斥着过时的评论和标记，导致文件杂乱。或者您需要在将文档发送给客户之前进行清理。是否听起来很熟悉？

以编程方式删除 pdf 注释 并不仅仅是一个锦上添花的功能——它对于在自动化工作流中保持文档的整洁、专业至关重要。无论您处理的是法律合同、技术文档还是协作评审，了解如何高效地剥离不需要的批注都能为您节省大量手动工作时间。

让我们深入了解并顺畅地实现批注删除功能。

快速答案

  • 代码的作用是什么？ 它加载文档，过滤掉不需要的批注，并保存一个干净的副本。
  • 我可以只删除特定的批注吗？ 可以——通过类型、作者、页码或自定义元数据进行过滤。
  • 是否需要许可证？ 免费的 30 天试用可用于开发；商业使用需要正式许可证。
  • 大型 PDF 会导致内存问题吗？ 使用 using 块和批处理以保持低内存使用。
  • 这适用于除 PDF 之外的其他格式吗？ 当然——GroupDocs.Annotation 支持 Word、Excel、PowerPoint 等。

什么是 GroupDocs.Annotation？

GroupDocs.Annotation 是一个 .NET 库，允许您在超过 30 种文件格式（包括 PDF、DOCX、XLSX 和 PPTX）中添加、读取、编辑和删除批注。它在不将整个文件加载到内存的情况下处理高达 500 MB 的文档，非常适合高并发服务器环境。

为什么要以编程方式删除批注？

自动化批注删除可确保每个通过工作流的文档都是干净、专业且合规的。它消除手动工作，降低意外数据泄露的风险，并保持文件体积小，便于存储和索引。

  • 自动化就绪 – 在每个工作流阶段都可以自动生成干净的版本。
  • 专业交付 – 客户面对的 PDF 中不会出现零散的评论或标记。
  • 合规性 – 某些行业禁止在提交的文档中出现隐藏的评论。
  • 存储效率 – 去除批注的 PDF 更小，索引更快。

前置条件和设置

开发环境

  • .NET Core 3.1、.NET 5+ 或 .NET Framework 4.7.2+
  • Visual Studio 2022（或您喜欢的任何 C# IDE）
  • 熟悉 using 语句和异常处理的基本知识

必需的包

GroupDocs.Annotation for .NET（示例使用 25.4.0 版；更新的版本完全兼容）。

安装 GroupDocs.Annotation

Package Manager 控制台（最常用）：

Install-Package GroupDocs.Annotation -Version 25.4.0

Package Manager UI： 搜索 “GroupDocs.Annotation” 并安装最新的稳定版本。

.NET CLI（如果您是命令行用户）：

dotnet add package GroupDocs.Annotation --version 25.4.0

获取许可证

生产环境需要许可证文件。您可以先使用免费试用。

用于开发/测试：

  1. 访问 Temporary License Page
  2. 请求 30 天评估许可证
  3. 通过电子邮件接收 .lic 文件

基本许可证设置：
License 是 GroupDocs.Annotation 提供的用于将许可证文件应用于库的类。

using System;
using GroupDocs.Annotation;

class Program
{
    static void Main(string[] args)
    {
        // Set up your license (skip this during trial period)
        License lic = new License();
        lic.SetLicense("path-to-your-license.lic");
        
        Console.WriteLine("GroupDocs.Annotation is ready to rock!");
    }
}

专业提示： 将许可证存放在安全位置，并使用 License license = new License(); license.SetLicense("path/to/license.lic"); 加载。生产环境中切勿硬编码绝对路径。

步骤实现指南

如何删除特定的 pdf 批注？

本节说明如何加载 PDF，识别要丢弃的批注，并在保留原始内容的同时保存清理后的副本。

步骤 1：加载文档

Annotator 是 GroupDocs.Annotation 的核心类，用于打开文件并公开其批注集合。

string inputFilePath = "YOUR_DOCUMENT_DIRECTORY/ANNOTATED.pdf"; // Replace with your actual path

using (Annotator annotator = new Annotator(inputFilePath))
{
    // All the magic happens inside this using block
    // The using statement ensures proper resource cleanup
}

常见陷阱： 确保文件路径正确且文件未被其他进程锁定。路径拼写错误是导致 “文件未找到” 错误的常见原因。

步骤 2：获取并过滤批注

Annotation 对象代表单个标记项，如评论、高亮或印章。您可以在决定删除之前检查每个批注的类型、作者、页码或自定义元数据。

var annotations = annotator.Get();
Console.WriteLine($"Found {annotations.Count} annotations in the document");

// Let's see what we're working with
foreach (var annotation in annotations)
{
    Console.WriteLine($"Type: {annotation.Type}, Page: {annotation.PageNumber}");
}

// Remove the first annotation (basic example)
if (annotations.Count > 0)
{
    Console.WriteLine($"Removing annotation of type: {annotations[0].Type}");
    annotator.Remove(annotations[0]);
}

工作原理： 先进行过滤，可避免在清除内部评论时误删有用的标记（如法律高亮）。

步骤 3：保存清理后的文档

为清理后的文件使用不同的名称（例如 cleaned_ 前缀或时间戳），以免覆盖原始文件。

string outputDirectory = "YOUR_OUTPUT_DIRECTORY"; // Your output folder
string outputPath = Path.Combine(outputDirectory, "cleaned_" + Path.GetFileName(inputFilePath));

// Save the document with annotations removed
annotator.Save(outputPath);
Console.WriteLine($"Clean document saved to: {outputPath}");

文件命名策略： cleaned_2024_09_15_myfile.pdf 便于追踪处理日期。

如何删除所有 pdf 批注（彻底清除）？

当需要彻底清空时，此方法一次性删除所有批注。

RemoveAll 删除已加载文档中的所有批注。

string inputFilePath = "YOUR_DOCUMENT_DIRECTORY/ANNOTATED.pdf";
string outputPath = "YOUR_OUTPUT_DIRECTORY/completely_clean.pdf";

using (Annotator annotator = new Annotator(inputFilePath))
{
    var annotations = annotator.Get();
    
    if (annotations.Count > 0)
    {
        Console.WriteLine($"Removing all {annotations.Count} annotations...");
        
        // Remove all annotations in one go
        foreach (var annotation in annotations)
        {
            annotator.Remove(annotation);
        }
        
        annotator.Save(outputPath);
        Console.WriteLine("All annotations removed successfully!");
    }
    else
    {
        Console.WriteLine("No annotations found in the document.");
    }
}

常见问题与解决方案

问题 1：“文件被锁定” 异常

症状： 文件正在使用时抛出的异常。
解决方案： 使用 using 语句包装文件访问，并确保没有其他进程持有文件句柄。

// DON'T do this
var annotator1 = new Annotator(filePath);
var annotator2 = new Annotator(filePath); // This might fail

// DO this instead
using (var annotator = new Annotator(filePath))
{
    // All your work here
} // Automatically disposed and file is released

问题 2：批注未实际删除

症状： 代码运行但批注仍然存在。
常见原因： 可能检查了错误的输出文件或过滤了错误的批注类型。
调试方法：

var annotations = annotator.Get();
foreach (var annotation in annotations)
{
    Console.WriteLine($"ID: {annotation.Id}, Type: {annotation.Type}");
    Console.WriteLine($"Page: {annotation.PageNumber}, Author: {annotation.User}");
}

问题 3：大型文档的内存问题

症状： 在大于 100 MB 的 PDF 上出现崩溃或严重卡顿。
解决方案： 将文档分批处理，并及时释放资源。

// For very large documents, consider processing page by page
using (var annotator = new Annotator(largePdfPath))
{
    var annotations = annotator.Get();
    
    // Process in chunks of 50 annotations
    for (int i = 0; i < annotations.Count; i += 50)
    {
        var batch = annotations.Skip(i).Take(50);
        foreach (var annotation in batch)
        {
            annotator.Remove(annotation);
        }
        
        // Optional: Force garbage collection for very large documents
        GC.Collect();
    }
    
    annotator.Save(outputPath);
}

性能优化技巧

批处理策略

将批注收集到列表中，一次性批量删除，以减少 API 调用。

using (var annotator = new Annotator(inputPath))
{
    var annotations = annotator.Get();
    var toRemove = annotations.Where(a => ShouldRemoveAnnotation(a)).ToList();
    
    Console.WriteLine($"Removing {toRemove.Count} out of {annotations.Count} annotations");
    
    // Remove all at once instead of individual Remove() calls
    foreach (var annotation in toRemove)
    {
        annotator.Remove(annotation);
    }
    
    annotator.Save(outputPath);
}

bool ShouldRemoveAnnotation(AnnotationBase annotation)
{
    // Your custom logic here
    return annotation.Type == AnnotationType.Area || 
           annotation.CreatedOn < DateTime.Now.AddMonths(-6);
}

内存管理最佳实践

  • 始终使用 using 语句进行自动释放。
  • 不要同时加载多个大型 PDF。
  • 当内存受限时，顺序处理文档而非并行。

缓存许可证对象

在应用启动时创建一次 License 实例，并在每个文档处理时复用。

public class DocumentProcessor
{
    private static readonly License _license = new License();
    
    static DocumentProcessor()
    {
        _license.SetLicense("your-license-path.lic");
    }
    
    public void ProcessDocument(string filePath)
    {
        // License is already set, just use the annotator
        using (var annotator = new Annotator(filePath))
        {
            // Your processing logic
        }
    }
}

实际使用案例与示例

场景 1：法律文档工作流

律所需要向客户发送干净的合同，同时保留内部评论供内部审阅。

public void PrepareClientDocument(string internalContractPath, string clientVersion)
{
    using (var annotator = new Annotator(internalContractPath))
    {
        var annotations = annotator.Get();
        
        // Remove only internal comments, keep client-facing highlights
        var internalComments = annotations.Where(a => 
            a.Type == AnnotationType.TextField && 
            a.User?.Contains("@lawfirm.com") == true);
            
        foreach (var comment in internalComments)
        {
            annotator.Remove(comment);
        }
        
        annotator.Save(clientVersion);
    }
}

场景 2：自动化报告生成

每月的分析报告会经过审阅周期；最终分发版本必须没有批注。

public void FinalizeReport(string draftPath, string finalPath)
{
    using (var annotator = new Annotator(draftPath))
    {
        var annotations = annotator.Get();
        
        // Remove all review comments but keep approved highlights
        var reviewComments = annotations.Where(a => 
            a.Type == AnnotationType.TextField ||
            a.Type == AnnotationType.Point);
            
        Console.WriteLine($"Cleaning {reviewComments.Count()} review annotations...");
        
        foreach (var annotation in reviewComments)
        {
            annotator.Remove(annotation);
        }
        
        annotator.Save(finalPath);
        Console.WriteLine($"Final report ready: {finalPath}");
    }
}

高级错误处理

稳健的生产代码应预判并记录常见异常，如 IncorrectPasswordException 或 OutOfMemoryException。

当未提供正确密码而打开受密码保护的 PDF 时，会抛出 IncorrectPasswordException。

public bool RemoveAnnotationsSafely(string inputPath, string outputPath)
{
    try
    {
        using (var annotator = new Annotator(inputPath))
        {
            var annotations = annotator.Get();
            
            if (annotations.Count == 0)
            {
                Console.WriteLine("No annotations to remove.");
                // Still copy the file to output location
                File.Copy(inputPath, outputPath, overwrite: true);
                return true;
            }
            
            foreach (var annotation in annotations)
            {
                try
                {
                    annotator.Remove(annotation);
                }
                catch (Exception ex)
                {
                    Console.WriteLine($"Failed to remove annotation {annotation.Id}: {ex.Message}");
                    // Continue with other annotations
                }
            }
            
            annotator.Save(outputPath);
            Console.WriteLine($"Successfully processed document: {Path.GetFileName(outputPath)}");
            return true;
        }
    }
    catch (FileNotFoundException)
    {
        Console.WriteLine($"Input file not found: {inputPath}");
        return false;
    }
    catch (UnauthorizedAccessException)
    {
        Console.WriteLine($"Access denied. Check file permissions for: {inputPath}");
        return false;
    }
    catch (Exception ex)
    {
        Console.WriteLine($"Unexpected error: {ex.Message}");
        return false;
    }
}

测试实现

一个简短的单元测试可以验证处理后批注计数是否降至零。

public void TestAnnotationRemoval()
{
    string testFile = "test-document-with-annotations.pdf";
    string outputFile = "test-output.pdf";
    
    // Before removal
    using (var annotator = new Annotator(testFile))
    {
        var beforeCount = annotator.Get().Count;
        Console.WriteLine($"Annotations before removal: {beforeCount}");
    }
    
    // Remove annotations
    bool success = RemoveAnnotationsSafely(testFile, outputFile);
    
    if (success)
    {
        // After removal
        using (var annotator = new Annotator(outputFile))
        {
            var afterCount = annotator.Get().Count;
            Console.WriteLine($"Annotations after removal: {afterCount}");
            Console.WriteLine($"Removed: {beforeCount - afterCount} annotations");
        }
    }
}

故障排查指南

  • IncorrectPasswordException – 通过 LoadOptions 提供 PDF 密码。

LoadOptions loadOptions = new LoadOptions { Password = “your-pdf-password” }; using (var annotator = new Annotator(filePath, loadOptions)) { // Your code here }


- **Annotations still visible** – 某些 PDF 查看器会缓存批注流；刷新或使用其他查看器打开文件。  

- **OutOfMemoryException** – 将 PDF 分成更小的块处理或提升应用的内存上限。  

- **Certain annotation types won’t delete** – 使用 `annotation.Type` 识别并单独处理表单字段等特殊类型。  

## 性能基准

基于对 GroupDocs.Annotation 25.4.0 的内部测试：

- **小型 PDF（< 1 MB，< 50 条批注）：** < 0.5 秒  
- **中型 PDF（1‑10 MB，50‑200 条批注）：** 1‑3 秒  
- **大型 PDF（10‑50 MB，200+ 条批注）：** 5‑15 秒  
- **超大 PDF（> 50 MB）：** 建议使用批处理以保持每文件不超过 20 秒  

## 资源

- [GroupDocs.Annotation 文档](https://docs.groupdocs.com/annotation/net/)  
- [API 参考](https://reference.groupdocs.com/annotation/net/)  
- [下载 GroupDocs.Annotation for .NET](https://releases.groupdocs.com/annotation/net/)  
- [购买选项](https://purchase.groupdocs.com/buy)  
- [支持论坛](https://forum.groupdocs.com/c/annotation/)  

## 结论

您现在拥有了在 C# 中 **remove pdf annotations** 的完整工具包。请记住：

1. 使用 `using` 块进行资源的清理释放。  
2. 在删除前过滤批注，以避免意外的数据丢失。  
3. 按上述策略处理受密码保护的文件和大型 PDF。  
4. 在投产前使用真实文档进行测试。  

将这些模式集成到更广泛的文档处理流水线中，用户每次都能获得更清洁、更专业的 PDF。

## 常见问题

**问：我可以删除 Word 文档中的批注，而不仅仅是 PDF 吗？**  
答：可以——GroupDocs.Annotation 支持 DOCX、XLSX、PPTX 等多种格式。加载相应文件类型后，使用相同的 API 调用即可。

**问：我如何只删除特定类型的批注（例如仅删除评论）？**  
答：在调用删除方法之前，通过 `annotation.Type == AnnotationType.Comment` 过滤批注集合。  
```csharp
var commentsOnly = annotations.Where(a => a.Type == AnnotationType.TextField);

问：删除批注会影响文档的布局或格式吗？
答：不会。批注作为覆盖对象存储，删除后底层内容保持不变。

问：我可以撤销批注删除吗？
答：库不提供 “撤销” 功能。请始终在原始文档的副本上操作并保留备份。

问：我该如何处理受密码保护的 PDF？
答：在创建 Annotator 实例时，通过 LoadOptions 传入密码。

问：是否可以根据作者删除批注？
答：可以——检查 annotation.User 属性，仅删除匹配指定作者名称的批注。

问：隐藏批注和删除批注有什么区别？
答：隐藏仅在查看器中使其不可见；删除则永久从文件中移除。GroupDocs.Annotation 仅支持删除。

最后更新： 2026-06-01
测试环境： GroupDocs.Annotation 25.4.0 for .NET
作者： GroupDocs

相关教程