使用 GroupDocs.Watermark for Java 为 Excel 工作表添加文字水印

当您需要 如何对 Excel 添加水印 工作簿——尤其是那些包含敏感数据的工作簿——时，添加清晰、专业的文字水印是保护内容并强化品牌形象的最有效方式之一。在本教程中，我们将逐步演示如何使用 GroupDocs.Watermark for Java 库 为 Excel 添加文字水印 文件，涵盖从项目设置到保存最终受保护工作簿的全部步骤。

快速答案

  • 我应该使用哪个库？ GroupDocs.Watermark for Java.
  • 我可以为每个工作表添加文字水印吗？ Yes – iterate over each worksheet and apply the same watermark.
  • 我需要许可证吗？ A free trial works for evaluation; a permanent license is required for production.
  • 支持哪个 Java 版本？ JDK 8 or later.
  • 水印会影响单元格数据吗？ No, it only overlays images within the worksheet.

什么是 Excel 水印？

Excel 水印是指将可见标记（文字或图像）直接嵌入工作表的可视元素（例如图像）中，使打开文件的任何人都能看到所有权或保密声明。这种技术有助于阻止未授权的分发，并为您的报告增添专业外观。

为什么使用 Java 为 Excel 添加文字水印？

  • 安全性 – 明确标示机密或专有信息。
  • 品牌一致性 – 在所有共享的电子表格中强化企业品牌形象。
  • 自动化 – Java 让您能够以编程方式嵌入水印，节省手动编辑的时间。
  • 跨格式支持 – 支持 .xlsx 和传统 .xls 文件。

前置条件

  • Java Development Kit (JDK) 8 或更高版本。
  • Maven 用于依赖管理。
  • 对 Java 语法和面向对象概念有基本了解。

设置 GroupDocs.Watermark for Java

首先，将 GroupDocs.Watermark 依赖添加到您的 Maven 项目中。

使用 Maven

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/watermark/java/</url>
   </repository>
</repositories>

<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-watermark</artifactId>
      <version>24.11</version>
   </dependency>
</dependencies>

直接下载

或者，从 GroupDocs.Watermark for Java releases 下载最新的 JAR 包。

许可证获取

  • Free Trial – 免费试用，探索所有功能。
  • Temporary License – 临时许可证，用于短期测试。
  • Purchase – 购买后解锁完整的生产功能。

基本初始化

import com.groupdocs.watermark.Watermarker;
// Initialize watermarker instance for your document
Watermarker watermarker = new Watermarker("path/to/your/spreadsheet.xlsx");

实现指南

功能 1：创建文字水印并配置其属性

创建和自定义水印包括设置其文字、字体、对齐方式、旋转角度和缩放比例。

步骤概览

定义水印

import com.groupdocs.watermark.common.HorizontalAlignment;
import com.groupdocs.watermark.common.VerticalAlignment;
import com.groupdocs.watermark.options.SpreadsheetLoadOptions;
import com.groupdocs.watermark.watermarks.Font;
import com.groupdocs.watermark.watermarks.SizingType;
import com.groupdocs.watermark.watermarks.TextWatermark;

// Create a new TextWatermark object
text watermark = new TextWatermark("Protected image", new Font("Arial", 8));

// Configure the watermark properties
text watermark.setHorizontalAlignment(HorizontalAlignment.Center);
text watermark.setVerticalAlignment(VerticalAlignment.Center);
text watermark.setRotateAngle(45); // Set rotation angle
text watermark.setSizingType(SizingType.ScaleToParentDimensions);
text watermark.setScaleFactor(1); // Maintain original size scale factor
  • Text and Font – 选择清晰的文字信息和易读的字体。
  • Alignment – 居中对齐适用于大多数图像。
  • Rotation & Scaling – 45° 的倾斜角度使水印显眼且不遮挡图像。

功能 2：加载用于水印的电子表格文档

使用适当的选项加载工作簿，以便 GroupDocs 能够访问其内部图像。

import com.groupdocs.watermark.options.SpreadsheetLoadOptions;
// Load your Excel spreadsheet
documentLoadOptions = new SpreadsheetLoadOptions();
Watermarker watermarker = new Watermarker("YOUR_DOCUMENT_DIRECTORY/spreadsheet.xlsx", documentLoadOptions);

功能 3：在工作表的图像上添加文字水印

遍历第一个工作表中的图像，并应用已配置的水印。

import com.groupdocs.watermark.contents.SpreadsheetContent;
import com.groupdocs.watermark.contents.WatermarkableImageCollection;

// Access content from your loaded document
SpreadsheetContent content = watermarker.getContent(SpreadsheetContent.class);
WatermarkableImageCollection images = content.getWorksheets().get_Item(0).findImages();

for (com.groupdocs.watermark.contents.WatermarkableImage image : images) {
    // Add the configured watermark to each image in the worksheet
    image.add(watermark);
}

功能 4：保存并关闭已加水印的电子表格文档

将更改持久化到新文件并清理资源。

// Save the changes to a new file
watermarker.save("YOUR_OUTPUT_DIRECTORY/spreadsheet-out.xlsx");
// Close the watermarker instance to free resources
watermarker.close();

实际应用

  • 文档安全 – 保护机密的财务模型或人力资源数据。
  • 品牌推广 – 在所有共享报告中插入公司口号或法律声明。
  • 版权保护 – 通过标记每个导出图像来防止抄袭。

性能考虑

  • 保持 GroupDocs.Watermark 为最新版本，以获得最新的性能优化。
  • 及时释放 Watermarker 实例（调用 close()）以释放内存。
  • 对于非常大的工作簿，分批处理工作表以避免高内存消耗。

常见问题及解决方案

问题解决方案
Watermark not visible确认工作表实际包含图像；API 只对图像加水印，不会对单元格加水印。
Misaligned watermark调整 HorizontalAlignment / VerticalAlignment 或更改 RotateAngle。
Out‑of‑memory errors on big files增加 JVM 堆大小（-Xmx）或单独处理每个工作表。
License errors确保在项目中正确引用试用或永久许可证文件。

常见问答

Q: 我可以在所有 Excel 版本上使用吗？
A: 是的，GroupDocs 支持 .xlsx 和 .xls 两种格式。

Q: 如果我的水印未正确显示怎么办？
A: 仔细检查对齐设置，并确保图像尺寸适合所选的缩放比例。

Q: 如何进一步自定义字体样式？
A: 使用 Font 类设置粗体、斜体、颜色或其他排版属性。

Q: 是否可以为工作簿中的所有工作表添加水印？
A: 完全可以——遍历 content.getWorksheets()，对每个工作表使用相同的 image.add(watermark) 逻辑。

Q: 如何高效处理大型 Excel 文件？
A: 逐步处理工作表，保存后关闭每个 Watermarker，并考虑增大 JVM 堆大小。

资源

通过将这些步骤集成到您的 Java 项目中，您可以快速 为 Excel 添加水印，确保安全性和品牌一致性。

最后更新： 2026-03-22
测试环境： GroupDocs.Watermark 24.11 for Java
作者： GroupDocs