如何使用 GroupDocs.Parser 在 Java 中從 Word 文件提取文字

您是否想使用 Java 自動化從 Microsoft Word 文件的每一頁提取文字?本指南將示範如何使用 GroupDocs.Parser 快速且可靠地從 word 檔案提取文字。無論您是建立搜尋索引、遷移舊有內容,或執行文件分析,以下步驟都會帶您完整完成整個流程。

快速答覆

  • 什麼程式庫可以在 Java 中提取 Word 文字? GroupDocs.Parser for Java.
  • 我需要授權嗎? A free trial works for evaluation; a commercial license is required for production.
  • 需要哪個 Java 版本? JDK 8 or higher.
  • 我可以逐頁提取文字嗎? Yes, using the TextReader API.
  • 支援 Maven 嗎? Absolutely – add the GroupDocs repository and dependency.

什麼是「從 word 提取文字」?

從 word 文件提取文字是指讀取 .docx.doc 檔案的原始文字內容,而不包含格式、影像或其他二進位資料。這讓後續的處理如索引、情感分析或資料遷移成為可能。

為什麼要使用 GroupDocs.Parser for Java?

  • 高準確度 – 能可靠地解析複雜的 Word 結構。
  • 頁面層級存取 – 讓您能逐頁處理,適合大型文件。
  • 跨格式支援 – 同一套 API 可用於 PDF、試算表等,讓您的程式具備未來延伸性。
  • 簡易 Maven 整合 – 只需加入單一相依性即可開始解析。

前置條件

  • Java Development Kit (JDK): 8 版或更新版本。
  • Maven: 用於相依性管理。
  • 具備 Java 及 Maven 專案結構的基本知識。

既然您已掌握基礎,接下來讓我們設定此程式庫。

如何設定 GroupDocs.Parser for Java

Maven 設定

將 GroupDocs 儲存庫與 parser 相依性加入您的 pom.xml

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

<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-parser</artifactId>
      <version>25.5</version>
   </dependency>
</dependencies>

直接下載(備選)

如果您不想使用 Maven,也可以從 GroupDocs.Parser for Java releases 下載最新的 JAR。

取得授權

先使用免費試用版或申請臨時授權。若用於正式環境,需購買完整授權以解鎖全部功能。

基本初始化

匯入核心類別並建立 Parser 實例:

import com.groupdocs.parser.Parser;

此行程式碼為 parse word java 操作準備環境。

如何從 Word 文件頁面提取文字

步驟 1 – 定義文件路徑

指定 Word 檔案在磁碟上的位置:

String documentPath = "YOUR_DOCUMENT_DIRECTORY/SampleDocxWithToc.docx";

YOUR_DOCUMENT_DIRECTORY 替換為實際存放 .docx 檔案的資料夾路徑。

步驟 2 – 建立 Parser 實例

使用 try‑with‑resources 區塊開啟文件,使 Parser 能自動關閉:

try (Parser parser = new Parser(documentPath)) {
    // The rest of the steps will be executed here
}

步驟 3 – 取得文件資訊

取得中繼資料,包括總頁數:

IDocumentInfo documentInfo = parser.getDocumentInfo();

步驟 4 – 逐頁迭代

遍歷每一頁以個別處理:

for (int p = 0; p < documentInfo.getPageCount(); p++) {
    // Operations on each page are performed here
}

步驟 5 – 從當前頁面提取文字

使用 TextReader 取得原始文字:

try (TextReader reader = parser.getText(p)) {
    String pageText = reader.readToEnd();
    
    // You can now perform operations on the extracted text, such as saving it to a file.
}

此時您已取得每頁的 java extract docx text,可進行後續處理。

常見問題與故障排除

  • 檔案路徑不正確 – 請再次確認絕對或相對路徑,以避免 FileNotFoundException
  • 程式庫版本不匹配 – 確認 GroupDocs.Parser 版本與您的 JDK 相符。
  • 缺少權限 – 應用程式必須具備讀取文件資料夾的權限。
  • 大型檔案 – 請分批處理或串流頁面,以降低記憶體使用量。

提取 Word 文字的實務應用

  1. 內容索引 – 將頁面文字輸入至如 Elasticsearch 的搜尋引擎。
  2. 資料遷移 – 將舊有 Word 內容遷移至現代的 CMS 或資料庫。
  3. 文件分析 – 在每頁上執行關鍵字頻率或情感分析。

效能建議

  • 僅在 CPU 與記憶體足夠時,才平行處理文件。
  • 盡可能重複使用同一個 Parser 實例進行多次讀取。
  • 使用 Java Flight Recorder 進行程式碼效能分析,以找出瓶頸。

結論

您現在已學會如何設定 GroupDocs.Parser for Java、逐頁解析 Word 檔案,並提取文字以供任何後續情境使用。若想探索更多格式與進階功能,請參閱官方 documentation

下一步

  • 嘗試使用相同的 API 提取表格或影像。
  • 結合提取的文字與自然語言處理庫,以獲得更深入的洞見。

行動呼籲: 在您的下一個 Java 專案中實作此解決方案,體驗文字提取的簡化效果!

常見問答區

常見問題

  1. 如何處理加密的 Word 文件?
    • 使用接受密碼參數的 Parser 建構子來開啟加密檔案。
  2. GroupDocs.Parser 能從 Word 文件提取影像嗎?
    • 可以,您可以使用 GroupDocs.Parser 提供的方法來提取影像。
  3. 是否可以使用 GroupDocs.Parser for Java 從 PDF 提取文字?
    • 當然可以!GroupDocs.Parser 支援多種文件格式,包括 PDF。
  4. 執行 GroupDocs.Parser 的系統需求是什麼?
    • 需要相容的 JDK(8 或以上)以及支援 Java 應用程式執行的作業系統環境。
  5. 如何在現有應用程式中開始使用 GroupDocs.Parser?
    • 如前所示整合 Maven 相依性,初始化 Parser 類別,即可依需求開始提取內容。

資源


最後更新: 2026-03-09
測試版本: GroupDocs.Parser 25.5 for Java
作者: GroupDocs