如何在 GroupDocs.Search 中啟用模糊搜尋(Java) – 入門教學

在本完整指南中,您將學習如何使用 GroupDocs.Search 程式庫 enable fuzzy search java。我們將逐步說明安裝 SDK、套用授權、設定模糊匹配,以及索引各種文件類型,讓使用者即使拼寫錯誤或使用不同術語,也能找到相關內容。完成本教學後,您將在 15 分鐘內擁有一個完整運作的搜尋解決方案。

快速回答

  • 第一步是什麼? 將 GroupDocs.Search 相依性加入您的 Maven pom.xml 或 Gradle build.gradle。
  • 我需要授權嗎? 是的——臨時開發授權可用於測試;正式部署則需要永久授權。
  • 哪個 IDE 最適合? 任何支援 Maven 或 Gradle 的 Java IDE(IntelliJ IDEA、Eclipse、VS Code)。
  • 我可以索引 PDF、Word 與 Excel 檔案嗎? 當然可以——GroupDocs.Search 原生支援超過 50 種檔案格式,包括 PDF、DOCX、XLSX、PPTX 以及多種影像類型。
  • 如何啟用模糊搜尋? 在執行查詢前,於 SearchOptions 實例上將 fuzzySearch 屬性設為 true。
  • 整個設定需要多久? 通常在全新專案中少於 15 分鐘即可完成。

在 GroupDocs.Search 中「enable fuzzy search」是什麼?

啟用模糊搜尋會告訴引擎在匹配查詢詞時容忍輕微的拼寫變化、缺字或字母顛倒。此功能在使用者打錯字、OCR 產生的文字或多語言內容等情境下,大幅提升可發現性,因為搜尋演算法即使關鍵字不完全相符,也會返回相關文件。

為何要為 Java 配置 GroupDocs.Search 並啟用模糊搜尋?

您可以透過極少的程式碼即獲得即時、可投入生產的搜尋功能,同時提供更順暢的使用者體驗。GroupDocs.Search 於不將文件完整載入記憶體的情況下建立索引,支援 50+ 輸入與輸出格式,且可在一般硬體上擴展至 數百萬檔案。啟用模糊搜尋會加入容錯層,將失敗查詢減少最多 80 %,將拼寫錯誤的使用者輸入轉換為精確結果,且不需額外開發工作。

前置條件

  • Java Development Kit (JDK) 8 或更新版本。
  • 用於相依性管理的 Maven 3 或 Gradle 5。
  • 臨時或永久的 GroupDocs.Search 授權金鑰。

步驟指南

步驟 1:將 GroupDocs.Search 加入您的專案

將 GroupDocs.Search 相依性加入您的 pom.xml(Maven)或 build.gradle(Gradle)。這會使程式庫在編譯與執行時可於 classpath 中取得。

步驟 2:套用授權

License 會載入並驗證 GroupDocs.Search 授權檔案,解鎖所有高級功能,例如模糊匹配。建立 License 實例,並指向您從 GroupDocs 收到的 .lic 檔案。

步驟 3:初始化索引設定

定義磁碟上的資料夾以儲存索引檔案。您亦可在此階段設定大小寫敏感性、停用詞以及其他索引選項。

步驟 4:索引您的文件

Indexer 類別會讀取檔案、提取可搜尋的文字,並將資料寫入索引資料夾。它會自動偵測檔案類型,讓您可在不需額外程式碼的情況下混合 PDF、DOCX、XLSX 與影像檔案。

步驟 5:在查詢中啟用模糊搜尋

SearchOptions 會設定搜尋操作的參數,例如模糊匹配與過濾條件。
建立 SearchOptions 物件時,將其 fuzzySearch 標誌設為 true。您亦可調整 fuzzinessLevel(例如 2)以控制引擎的容忍度。

步驟 6:執行搜尋查詢

search 方法會對索引執行查詢並返回匹配結果。
使用查詢字串與已配置的 SearchOptions 呼叫 search 方法。該方法回傳 SearchResult 物件的清單,每個物件包含文件路徑與反映模糊匹配的相關性分數。SearchResult 代表單一文件匹配,包含其路徑與相關性分數。

步驟 7:檢視結果

SearchResult 代表單一文件匹配,包含其路徑與相關性分數。
遍歷 SearchResult 集合,顯示檔案名稱,並可選擇在 UI 中突顯匹配的詞彙。模糊匹配的相關性分數通常略低於精確匹配,您可利用此差異對結果排序。

常見問題與解決方案

  • 授權未被識別 – 驗證授權檔案路徑是否正確,且檔案版本與您使用的 GroupDocs.Search 版本相符。
  • 缺少文件格式 – 安裝可選的 groupdocs-conversion 附加元件,以支援較不常見的檔案類型。
  • 模糊搜尋未返回結果 – 確保 fuzzySearch 標誌為 true,且查詢長度符合最小字元要求(通常為三個字元)。
  • 效能瓶頸 – 使用增量索引,並將索引資料夾存放於 SSD 上,以提升讀寫速度。

常見問答

Q: 我可以在 Linux 伺服器上執行 GroupDocs.Search 嗎?
A: 是的,該程式庫與平台無關,能在任何支援 Java 的作業系統上運行。

Q: 我該如何將新檔案加入現有索引?
A: 再次使用新檔案呼叫 Indexer;SDK 會自動將它們合併至現有索引。

Q: 能否將搜尋結果限制在特定資料夾?
A: 可以,在執行查詢前於 SearchOptions 設定資料夾過濾條件。

Q: 臨時授權過期後會發生什麼?
A: API 會切換至功能受限的評估模式;將臨時金鑰換成永久授權即可恢復完整功能。

Q: GroupDocs.Search 支援模糊搜尋嗎?
A: 當然可以——在 SearchOptions 中啟用 fuzzySearch 標誌,即可取得包含輕微拼寫變化的結果。

Q: 我可以將模糊搜尋與其他過濾條件(如日期範圍)結合嗎?
A: 可以,您可以在保持模糊匹配啟用的同時,於 SearchOptions 加入其他過濾條件。

其他資源

可用教學

部署 GroupDocs.Search for Java: 完整設定指南

了解如何使用此步驟指南部署與設定 GroupDocs.Search for Java。提升您專案中的文件索引與搜尋功能。

有用連結


最後更新: 2026-10-17
測試環境: GroupDocs.Search 23.12 for Java
作者: GroupDocs

相關教學