Spotlight 搜尋失效、找不到檔案、顯示錯誤結果？手動觸發重建索引可修復損壞的中繼資料庫。透過「隱私權」清單加入再移除系統磁碟，強制 Spotlight 重新掃描建立索引。

圖形化介面重建步驟

1. 「系統設定」→「Siri 與聚焦搜尋」→「聚焦搜尋隱私權...」（舊版：系統偏好設定 → Spotlight → 隱私權）。
2. 點選「+」或拖曳 系統磁碟（通常為「Macintosh HD」或自訂名稱） 進入清單。
3. 彈出確認對話框點選「好」。
4. 選中剛加入的磁碟 → 點選「-」移出清單。
5. Spotlight 立即啟動重新索引，選單列放大鏡圖示出現脈動點表示索引中。

終端機指令重建（適合遠端/腳本自動化）

# 針對特定磁碟重建（需 sudo）
sudo mdutil -E /Volumes/Macintosh\ HD

# 針對所有磁碟重建
sudo mdutil -Ea

# 僅關閉索引（不重建）
sudo mdutil -i off /Volumes/Macintosh\ HD

# 重新開啟索引
sudo mdutil -i on /Volumes/Macintosh\ HD

進度監控與預期時間

• 點選選單列放大鏡圖示 → 底部顯示「索引中... 預計剩餘時間」。
• 終端機監控：mdutil -s /Volumes/Macintosh\ HD 顯示索引狀態。
• 索引耗時取決於檔案總數、磁碟速度（SSD 約 10-30 分鐘、HDD 可能數小時），期間 mdworker、mds 進程會佔用 CPU 與磁碟 IO，系統可能較緩慢。

常見問題排查

現象	可能原因	解決
索引卡住、進度條不動	特定檔案損壞/權限錯誤導致 mdworker 崩潰	查看 /var/log/system.log 搜尋 mdworker 錯誤，排除問題檔案或加入隱私權清單排除
外接磁碟不索引	磁碟格式非 APFS/HFS+、或啟用「忽略此磁碟」	隱私權清單確認未勾選該磁碟；NTFS/FAT32 磁碟原生不支援 Spotlight 索引
特定資料夾不想被索引	隱私需求、虛擬機映像檔、node_modules 等大量小檔	直接拖曳該資料夾至隱私權清單，Spotlight 永久忽略

⚠️ 注意：將磁碟加入隱私權清單會立即刪除該磁碟現有索引，移出後才重新建立；操作前確認重要資料已備份，索引期間避免大量檔案操作。