we keep all markdown formatting.

Check for any missing bold formatting.

Now produce final content.# 如何使用 GroupDocs.Search for Java 建立文件索引並加入文件

如果您需要 建立文件索引 檔案，以即時搜尋成千上萬的 PDF、DOCX、TXT 以及其他格式，GroupDocs.Search for Java 提供了簡潔的 API 讓您輕鬆完成。在本教學中，您將學習如何設定索引資料夾、將文件加入索引，以及優化搜尋效能，以應對真實世界的 Java 全文搜尋情境。

快速解答

  • 第一步是什麼？ 透過 Maven 安裝 GroupDocs.Search 或下載程式庫。
  • 如何將文件加入索引？ 在初始化索引後呼叫 index.add(yourDocumentsFolder)。
  • 哪個資料夾應該存放索引？ 使用像 output 這樣的專用資料夾，並以 new Index(indexFolder) 進行設定。
  • 我可以提升搜尋速度嗎？ 可以——定期維護索引並在背景執行緒中執行索引建立。
  • 我需要授權嗎？ 試用或暫時授權可用於測試；正式環境需購買正式授權。

什麼是文件索引？

文件索引是一種結構化的資料儲存，內含從來源檔案中擷取的可搜尋標記。透過 建立文件索引，您即可在所有已索引的內容上執行快速的全文查詢，而無需在執行時逐一掃描檔案。

為何使用 GroupDocs.Search for Java？

  • 高效能 – 內建最佳化即使在百萬檔案下亦能保持低延遲。
  • 易於整合 – 簡潔的 API 用於建立索引、加入文件與執行查詢。
  • 可擴充架構 – 可於本地或雲端部署，且可透過同義詞或排序功能自訂。
  • Java 全文搜尋 – 開箱即支援多種格式。

前置條件

  • Java Development Kit (JDK) 8 或以上。
  • IDE 如 IntelliJ IDEA 或 Eclipse。
  • Maven 用於相依管理。
  • 具備基本的 Java 程式開發經驗。

設定 GroupDocs.Search for Java

Maven 安裝

將以下內容加入您的 pom.xml 檔案：

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

<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-search</artifactId>
      <version>25.4</version>
   </dependency>
</dependencies>

直接下載

或者，直接從 GroupDocs.Search for Java releases 下載最新版本。

取得授權

  1. 免費試用 – 無需承諾即可探索所有功能。
  2. 暫時授權 – 在試用期結束後延長測試。
  3. 購買 – 取得正式授權以供生產環境使用。

基本初始化

import com.groupdocs.search.Index;

public class InitializeGroupDocs {
    public static void main(String[] args) {
        // Create an index in the specified folder
        String indexFolder = "YOUR_DOCUMENT_DIRECTORY\\output";
        Index index = new Index(indexFolder);
        
        System.out.println("GroupDocs.Search initialized successfully.");
    }
}

如何將文件加入索引

步驟 1：設定索引資料夾與來源資料夾

String indexFolder = "YOUR_DOCUMENT_DIRECTORY\\output\\AdvancedUsage\\Searching\\SynonymSearch";
String documentsFolder = "YOUR_DOCUMENT_DIRECTORY"; // Replace with your actual document path

說明：indexFolder 為儲存可搜尋索引的資料夾，而 documentsFolder 指向您想要 將文件加入索引 的檔案所在位置。

步驟 2：建立索引（設定索引資料夾）

Index index = new Index(indexFolder);

說明：此行會建立一個新的索引實例，並將資料寫入您先前設定的資料夾。

步驟 3：加入文件以進行索引

index.add(documentsFolder);

說明：add 方法會掃描 documentsFolder，並 將文件加入索引，使其內容可被搜尋。

疑難排解技巧

  • 缺少相依項目 – 再次確認 pom.xml 中的 Maven 條目。
  • 資料夾路徑無效 – 確認 indexFolder 與 documentsFolder 均已存在且 JVM 可存取。

處理大型文件

當您處理 GB 級別的 PDF 或大量的 DOCX 集合時，請考慮以下做法：

  1. 批次處理 – 將來源資料夾切分為較小的子資料夾，並對每個批次呼叫 index.add()。
  2. 背景索引 – 在獨立執行緒中執行索引程式碼，使主應用程式保持回應。
  3. 堆積記憶體調校 – 增加 JVM 的 -Xmx 設定，為大型檔案提供足夠記憶體。

優化搜尋效能

要 優化搜尋效能 並 提升搜尋延遲，請遵循以下最佳實踐：

  • 定期合併索引段 – 可減少查詢時的磁碟讀取次數。
  • 使用 index.update()（若支援）於大量新增後更新索引，而非重新建立索引。
  • 監控堆積記憶體使用量 – 大型索引可能佔用大量記憶體，請相應調整 JVM 參數。
  • 啟用快取 以加速常用查詢，前提是您的應用模式允許此做法。

實務應用

  1. 企業文件管理 – 快速檢索合約、政策或人力資源檔案。
  2. 法律研究 – 以最低延遲找到案件檔案與判例。
  3. 學術圖書館 – 讓學者能搜尋數千篇研究論文。

常見問題與解決方案

問題解決方案
大量索引時的記憶體不足錯誤將來源資料夾切分為較小的批次，分別索引每個批次。
搜尋返回過時結果在大量更新後重新開啟 Index 物件，或在支援時呼叫 index.update()。
授權未被識別確認授權檔案路徑正確，且授權版本與程式庫版本相符。

常見問答

Q: 需要的最低 Java 版本是什麼？
A: 建議使用 Java 8 或以上以確保完整相容性。

Q: 如何有效處理極大型文件集？
A: 使用批次處理、在背景執行緒中執行索引，並調整 JVM 記憶體設定。

Q: GroupDocs.Search 能部署於雲端環境嗎？
A: 可以，但需確保索引資料夾的儲存位置對所有實例皆可存取。

Q: 同義詞搜尋有什麼好處？
A: 它會將查詢詞擴展為相關詞彙，提高召回率，同時不犧牲精確度。

Q: 哪裡可以找到更進階的文件說明？
A: 請造訪官方 API 參考文件 GroupDocs.Search API Reference。

資源

遵循上述步驟後，您已了解如何 建立文件索引、將文件加入索引、設定索引資料夾，以及使用 GroupDocs.Search for Java 優化搜尋效能。祝開發順利！

最後更新： 2026-03-15
測試環境： GroupDocs.Search 25.4 for Java
作者： GroupDocs