Meilisearch 教學：搜「保濕」撈不到「保溼」，繁中站內搜尋要補三個設定

訪客在你的保養品官網搜「保濕」，商品名寫成「保溼」的那幾件就是不出來；搜你家品牌名，排第一的卻是不相干的東西。Meilisearch 是什麼，我在 Meilisearch 開箱 講過，這篇只講動手。

兩件事都跟安裝無關，是中文沒設好。

授權：社群版就夠，image 別拉錯

GitHub 59,447 顆星，最新版 v1.54.2（2026 年 9 月 29 日）。LICENSE 原文是「MIT AND BUSL-1.1」：主體是 MIT 的社群版（Community Edition），可免費商用；標成企業版（Enterprise Edition）的部分走 BUSL 1.1，只能測試、開發，上正式環境要跟官方簽約。

要多台互相備援，或資料大到要分片（sharding），才會碰到企業版。

Docker image 也分兩個：getmeili/meilisearch 是社群版，getmeili/meilisearch-enterprise 是企業版。授權檔怎麼讀，可以看 接案前先打開 LICENSE。

安裝與匯入資料

先在自己電腦跑，預設是 development 模式，打開 localhost:7700 有搜尋預覽。以下指令以 macOS／Linux 終端機為準，Windows 建議在 WSL 裡跑：

docker run -it --rm -p 7700:7700 -e MEILI_MASTER_KEY=你的金鑰 -v $(pwd)/meili_data:/meili_data getmeili/meilisearch:v1.54.2

上線時把 -it --rm 換成 -d、加上 -e MEILI_ENV=production，主金鑰變強制、搜尋預覽會關掉。

資料用 API 送 JSON、CSV 或 NDJSON，匯進 products 索引：

curl -X POST 'http://localhost:7700/indexes/products/documents' -H 'Authorization: Bearer 你的金鑰' -H 'Content-Type: application/json' --data-binary @products.json

1. 主金鑰（master key）至少 16 bytes，前端通常只放 Search API Key，主金鑰和 Admin Key 絕不能上前端
2. 每筆都要有主鍵（primary key，通常是 id 欄位），缺一筆整批不寫入
3. 回傳的只是任務編號（taskUid），要用 GET /tasks/編號 查狀態才知道成功沒，這種安靜的失敗最常被漏掉

官網、部落格不想匯出 JSON 的，雲端版有內建爬蟲，自架用 Scrapix。前端搜尋框用官方的 instant-meilisearch 搭 InstantSearch 接上。

中文斷詞：這段才是重點

官方文件寫中文用 jieba 字典斷詞（tokenization），有三件事要先知道。

繁體比簡體弱。 jieba 字典以簡體為主，Meilisearch 用的斷詞套件 charabia 有個 2025 年 4 月開、至今沒關的 issue：同一句話，簡體斷出「尊严」「权利」，繁體卻被切成「尊／嚴」「權／利」，簡繁寫法不同的字最容易被拆開。我的判斷是繁體多半搜得到，但排序會打折。

只比對詞的開頭。 2024 年有使用者回報、官方工程師解釋過（原文是簡體）：「带根毛芹」被切成「带／根毛／芹」，搜「毛芹」就找不到。解法是自訂字典（dictionary），把品牌名、商品名加進去當成一個詞。但同一則 issue 也回報，加了「毛芹」之後搜「芹」反而找不到。

短查詢的語言很難猜。 邊打邊搜常常只有兩三個字，中文跟日文漢字容易混。用 localizedAttributes 把欄位宣告成 cmn（普通話的語言代碼），搜尋時也帶 locales，兩邊斷詞才會一致。

錯字容忍：中文幾乎用不到

官方預設一個詞 5 個字元以上才容許 1 個錯字，9 個以上容許 2 個。英文打 sevem 找得到 seven，中文詞多半兩到四個字，門檻碰不到；調低也難救，打錯一個字連斷詞都跟著變。

中文要靠同義詞（synonyms）：「保濕／保溼」、品牌英文名跟中文俗稱。

字典和同義詞一個 PATCH 就能設好，語言宣告也能放同一包：

curl -X PATCH 'http://localhost:7700/indexes/products/settings' -H 'Authorization: Bearer 你的金鑰' -H 'Content-Type: application/json' --data-binary '{"dictionary":["你的品牌名"],"synonyms":{"保濕":["保溼"],"保溼":["保濕"]}}'

資源需求與雲端價格

官方建議磁碟抓原始資料的十倍，建索引預設最多吃三分之二記憶體。一般商品站資料量不大，真正要想的是要不要多養一個服務。

照官方試算器預設值，用量計費每月 30 美元；最小的 XS 機器 23 美元，但官方標的是開發測試用，正式站多半從 S（1 vCPU、2 GB）起跳。

我的建議

先在自己電腦跑起來，拿網站最常被搜的 30 個詞（尤其繁體）試一輪，不準的先補字典跟同義詞，再決定要不要上線。

上線後盯著那張「搜了沒結果」的詞表，那是訪客親口說要、你卻沒有的東西。自架沒有報表，GA4 加強型評估的 view_search_results 只記搜了什麼（search_term），不知道有沒有結果。要那張表，就在前端拿到搜尋回傳的 estimatedTotalHits 為 0 時（用頁碼分頁看 totalHits），多送一個自訂事件帶上搜尋詞。

引擎再快，沒人讀那張搜不到的詞表也是白搭。把那些詞變成內容的工具，我整理在 AI101。

常見問題