在 Java 中為 Excel 添加文字浮水印 – GroupDocs.Watermark

在當今的數位時代，保護試算表中的敏感資訊至關重要。使用 GroupDocs.Watermark for Java 可輕鬆 Add text watermark excel 檔案，該函式庫允許您直接在 Excel 活頁簿中嵌入自訂文字浮水印。本教學將帶您完成設定、基本使用以及進階樣式設定，讓您在確保文件安全的同時，保持品牌一致性。

快速解答

  • 此函式庫的功能是什麼？ 它會在 Excel 檔案中插入可自訂的文字浮水印，且不會更改原始內容。
  • 需要哪個版本？ GroupDocs.Watermark for Java 24.11 或更新版本。
  • 需要授權嗎？ 免費試用可用於評估；永久授權則會移除所有限制。
  • 可以只針對單一工作表嗎？ 可以 — 您可以將浮水印套用於特定工作表。
  • 在大型檔案上速度快嗎？ 是的，它使用串流方式處理多百頁的活頁簿，保持低記憶體使用量。

「add text watermark excel」是什麼？

Add text watermark excel 指的是將可見的文字覆蓋層嵌入 Excel 活頁簿，以表示機密性、所有權或品牌。此覆蓋層作為檔案的一部份儲存，於任何相容的檢視器開啟試算表時皆會顯示。

為什麼使用 GroupDocs.Watermark for Java？

GroupDocs.Watermark 支援 30+ 輸入與輸出格式，且可在不將整個活頁簿載入記憶體的情況下處理最高 200 MB 的 Excel 檔案，於一般伺服器硬體上提供次秒級的效能。其 API 完全支援執行緒安全，適合高吞吐量的企業管線。

前置條件

  1. 函式庫與相依性
    • GroupDocs.Watermark for Java（版本 24.11 或更新）
  2. 環境設定
    • 已安裝 Java Development Kit (JDK) 8 或更新版本
  3. 知識需求
    • 基本的 Java 程式設計技能
    • 熟悉 Maven 以管理相依性

如何添加文字浮水印至 Excel – 步驟指南

要在 Excel 活頁簿中嵌入文字浮水印，您首先使用 Watermarker 載入檔案，接著定義浮水印的外觀，最後在儲存前將其套用至目標工作表。此流程簡單明瞭，只需幾行 Java 程式碼即可實作，如下方程式碼片段所示。

步驟 1：載入 Excel 文件

Direct answer: 初始化 Watermarker 類別，傳入 Excel 檔案的路徑與適當的載入選項——此步驟會為浮水印操作做好文件的準備。

```xml
<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>


### 步驟 2：建立與設定文字浮水印
**Direct answer:** 實例化 `TextWatermark`，設定其文字、字型、大小、顏色與對齊方式，然後將其附加至 `SpreadsheetWatermarkOptions` 物件。  

import com.groupdocs.watermark.Watermarker;
import com.groupdocs.watermark.contents.SpreadsheetLoadOptions;

// Initialize load options
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();

// Create a watermarker instance for the Excel file
Watermarker watermarker = new Watermarker("YOUR_DOCUMENT_DIRECTORY/spreadsheet.xlsx", loadOptions);


### 步驟 3：將浮水印套用至目標工作表
**Direct answer:** 在 `Watermarker` 實例上使用 `add` 方法，傳入選項，並可選擇指定工作表索引以針對單一工作表。  

import com.groupdocs.watermark.options.HorizontalAlignment;
import com.groupdocs.watermark.options.VerticalAlignment;
import com.groupdocs.watermark.watermarks.Color;
import com.groupdocs.watermark.watermarks.Font;
import com.groupdocs.watermark.watermarks.TextWatermark;

// Create a text watermark
TextWatermark watermark = new TextWatermark("Confidential", new Font("Segoe UI", 19));

// Set size, alignment and color of the watermark
watermark.setSizingType(TextWatermark.SIZING_TYPE.FIT_TO_PAGE);
watermark.setHorizontalAlignment(HorizontalAlignment.Center);
watermark.setVerticalAlignment(VerticalAlignment.Center);


### 步驟 4：儲存已加浮水印的活頁簿
**Direct answer:** 呼叫 `Watermarker` 的 `save` 方法，提供輸出路徑與格式；函式庫會寫入加了浮水印的檔案，同時保留原始資料。  

// Save the watermarked document
watermarker.save("YOUR_OUTPUT_DIRECTORY/spreadsheet_watermarked.xlsx");

// Release resources
watermarker.close();


## 在試算表中套用文字效果於浮水印
透過線條樣式、不透明度與旋轉來提升可見度。

### 自訂線條格式
**Definition anchor:** `SpreadsheetTextEffects` 是一個協助類別，用於定義試算表中文本浮水印的線條粗細、虛線樣式與顏色。  

import com.groupdocs.watermark.options.SpreadsheetLineFormat;
import com.groupdocs.watermark.options.SpreadsheetDashStyle;
import com.groupdocs.watermark.options.SpreadsheetLineStyle;

// Set up text effects for the watermark
SpreadsheetTextEffects effects = new SpreadsheetTextEffects();
effects.getLineFormat().setEnabled(true);
effects.getLineFormat().setColor(Color.getRed());
effects.getLineFormat().setDashStyle(SpreadsheetDashStyle.DashDotDot);
effects.getLineFormat().setLineStyle(SpreadsheetLineStyle.Triple);
effects.getLineFormat().setWeight(1);


### 將效果套用至浮水印選項
將 `SpreadsheetTextEffects` 整合至 `SpreadsheetWatermarkOptions`，以控制浮水印在每頁的呈現方式。

import com.groupdocs.watermark.options.SpreadsheetWatermarkShapeOptions;

// Attach effects to the watermark shape options
SpreadsheetWatermarkShapeOptions options = new SpreadsheetWatermarkShapeOptions();
options.setEffects(effects);


## 實務應用
Text‑watermarked spreadsheets are useful in many scenarios:
1. **機密報告** – 標記財務報表為「Confidential」以防止洩漏。  
2. **Branding** – 在面向客戶的試算表上覆蓋公司標誌或口號。  
3. **Legal Documentation** – 清楚標示合約與協議，以確立真實性。  

## 效能考量
When handling large Excel workbooks, follow these best practices:
- **Stream instead of load:** GroupDocs.Watermark 以串流方式處理資料，避免整個文件的記憶體分配。  
- **Close resources promptly:** 使用 try‑with‑resources 或明確的 `close()` 呼叫以釋放檔案資源。  
- **Tune the JVM:** 為超過 100 MB 的檔案增加堆積大小（`-Xmx2g`），但需監控 GC 暫停。  

## 結論
現在您已了解如何使用 GroupDocs.Watermark for Java 為 **add text watermark excel** 檔案添加文字浮水印，從基本插入到進階樣式設定。可嘗試不同的字型、顏色與旋轉角度，以符合企業形象，並將此工作流程整合至更大的文件處理管線，以實現自動化保護。

## 常見問題

**Q:** GroupDocs.Watermark 支援的最大檔案大小是多少？  
**A:** 該函式庫可在不降低效能的情況下處理最高 **200 MB** 的 Excel 活頁簿，這歸功於其串流架構。

**Q:** 我可以自訂字型樣式與大小嗎？  
**A:** 可以 — `Font` 類別允許您設定字型族、大小、樣式（粗體、斜體）以及任何文字浮水印的顏色。

**Q:** 能否僅在特定工作表上添加浮水印？  
**A:** 完全可以。使用接受工作表索引或名稱的 `add` 方法重載，即可針對單獨的工作表。

**Q:** 在應用浮水印時應如何處理錯誤？  
**A:** 將程式碼包在 try‑catch 區塊中，捕捉 `IOException` 與 `WatermarkException`，以優雅地處理檔案存取問題與 API 錯誤。

**Q:** 之後需要時可以移除浮水印嗎？  
**A:** 可以 — GroupDocs.Watermark 提供 `remove` API，可在保留原始內容的同時移除先前添加的浮水印。

---

**最後更新:** 2026-07-15  
**測試環境:** GroupDocs.Watermark for Java 24.11  
**作者:** GroupDocs  

## 資源
- [GroupDocs.Watermark for Java 版本發布](https://releases.groupdocs.com/watermark/java/)
- [文件說明](https://docs.groupdocs.com/watermark/java/releases)

## 相關教學

- [使用 GroupDocs.Watermark Java SDK 為 Excel 試算表添加圖片浮水印](/watermark/java/spreadsheet-document-watermarking/add-image-watermark-spreadsheet-groupdocs-java/)
- [如何使用 GroupDocs.Watermark Java 為 Excel 添加附件（試算表浮水印）](/watermark/java/spreadsheet-document-watermarking/groupdocs-watermark-java-add-attachments-excel/)
- [GroupDocs.Watermark Java 的 Excel 試算表浮水印教學](/watermark/java/spreadsheet-document-watermarking/)