如何使用 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
TextReaderAPI. - 支援 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 文字的實務應用
- 內容索引 – 將頁面文字輸入至如 Elasticsearch 的搜尋引擎。
- 資料遷移 – 將舊有 Word 內容遷移至現代的 CMS 或資料庫。
- 文件分析 – 在每頁上執行關鍵字頻率或情感分析。
效能建議
- 僅在 CPU 與記憶體足夠時,才平行處理文件。
- 盡可能重複使用同一個
Parser實例進行多次讀取。 - 使用 Java Flight Recorder 進行程式碼效能分析,以找出瓶頸。
結論
您現在已學會如何設定 GroupDocs.Parser for Java、逐頁解析 Word 檔案,並提取文字以供任何後續情境使用。若想探索更多格式與進階功能,請參閱官方 documentation。
下一步
- 嘗試使用相同的 API 提取表格或影像。
- 結合提取的文字與自然語言處理庫,以獲得更深入的洞見。
行動呼籲: 在您的下一個 Java 專案中實作此解決方案,體驗文字提取的簡化效果!
常見問答區
常見問題
- 如何處理加密的 Word 文件?
- 使用接受密碼參數的
Parser建構子來開啟加密檔案。
- 使用接受密碼參數的
- GroupDocs.Parser 能從 Word 文件提取影像嗎?
- 可以,您可以使用 GroupDocs.Parser 提供的方法來提取影像。
- 是否可以使用 GroupDocs.Parser for Java 從 PDF 提取文字?
- 當然可以!GroupDocs.Parser 支援多種文件格式,包括 PDF。
- 執行 GroupDocs.Parser 的系統需求是什麼?
- 需要相容的 JDK(8 或以上)以及支援 Java 應用程式執行的作業系統環境。
- 如何在現有應用程式中開始使用 GroupDocs.Parser?
- 如前所示整合 Maven 相依性,初始化 Parser 類別,即可依需求開始提取內容。
資源
最後更新: 2026-03-09
測試版本: GroupDocs.Parser 25.5 for Java
作者: GroupDocs