Ricostruire indice Spotlight macOS Terminale consente di risolvere ricerche incomplete, file che non compaiono nei risultati e metadati aggiornati in ritardo senza installare applicazioni aggiuntive. Il comando principale è mdutil, uno strumento integrato in macOS che gestisce l’indicizzazione dei volumi. La procedura può essere eseguita dal Terminale con un account amministratore e richiede la password di macOS in alcuni passaggi. La ricostruzione non elimina documenti, immagini o applicazioni, ma rimuove e rigenera il database usato da Spotlight. Il tempo necessario dipende dal numero di file presenti sul disco e dall’attività del Mac durante l’operazione.

Che cosa fa la ricostruzione dell’indice Spotlight

Spotlight usa un indice per catalogare nomi dei file, contenuti, metadati, messaggi, applicazioni e altri elementi ricercabili in macOS. Quando l’indice è danneggiato o incompleto, Finder e Spotlight possono non mostrare file esistenti oppure restituire risultati vecchi.

Il comando mdutil permette di verificare lo stato dell’indicizzazione, disattivarla, riattivarla e cancellare l’indice esistente per avviarne una nuova generazione. La ricostruzione riguarda il volume indicato nel comando: / rappresenta il disco di avvio di macOS.

Prima di procedere, è utile verificare questi requisiti:

Un Mac con macOS avviato normalmente.
Un account con privilegi di amministratore.
Il Terminale, già incluso nella cartella Applicazioni.
Spazio libero sufficiente per consentire a macOS di creare nuovamente l’indice.
Il volume non deve essere escluso dalle impostazioni della privacy di Spotlight.

La ricostruzione dell’indice Spotlight non modifica i dati personali e non richiede la reinstallazione di macOS. Durante il processo, la ricerca può essere temporaneamente incompleta e il Mac può utilizzare più processore o disco.

Come controllare lo stato di Spotlight dal Terminale

Apri Terminale da Finder, seguendo il percorso Applicazioni > Utility > Terminale, quindi verifica lo stato del volume di avvio con questo comando:

mdutil -s /

Il risultato normalmente indica se l’indicizzazione è attiva, disattivata oppure non disponibile. Una risposta con “Indexing enabled” segnala che Spotlight è abilitato sul volume, ma non dimostra che la ricostruzione sia già terminata.

Per controllare tutti i volumi montati sul Mac, usa:

mdutil -a -s

L’opzione -a analizza tutti i volumi disponibili, compresi alcuni dischi esterni. Il volume di avvio può avere un nome diverso nel Finder, ma il percorso / resta il riferimento corretto per il disco dal quale macOS è stato avviato.

Se un disco esterno non viene indicizzato, controlla Impostazioni di Sistema > Siri e Spotlight > Privacy di Spotlight. In alcune versioni di macOS il pannello può essere indicato semplicemente come Spotlight o Privacy e sicurezza di Spotlight. Un volume presente in quell’elenco viene escluso deliberatamente dai risultati.

Come ricostruire indice Spotlight macOS Terminale

Passo 1: abilita l’indicizzazione del disco di avvio

Per assicurarti che Spotlight sia attivo sul volume principale, esegui:

sudo mdutil -i on /

Dopo aver premuto Invio, macOS può chiedere la password dell’account amministratore. Nel Terminale i caratteri della password non vengono visualizzati mentre li digiti: è normale. Premi Invio al termine.

Questo comando abilita il servizio di indicizzazione, ma non cancella necessariamente il database già presente. Per una ricostruzione effettiva è necessario usare l’opzione -E.

Passo 2: cancella e rigenera l’indice

Avvia la ricostruzione con:

sudo mdutil -E /

L’opzione -E ordina a macOS di cancellare l’indice Spotlight del volume selezionato e di ricrearlo. Il comando non cancella i file contenuti nel disco: interviene soltanto sul catalogo usato per le ricerche.

In alternativa, se Spotlight sembra bloccato o l’indicizzazione non riparte, puoi eseguire prima un ciclo di disattivazione e riattivazione:

sudo mdutil -i off /
sudo mdutil -i on /
sudo mdutil -E /

Il primo comando disattiva temporaneamente l’indicizzazione, il secondo la riattiva e il terzo forza la cancellazione del vecchio indice. Questa sequenza è più invasiva rispetto al solo comando mdutil -E, ma resta una procedura integrata in macOS.

Passo 3: ricostruisci l’indice di un disco esterno

Per un volume esterno devi indicare il percorso presente nella cartella /Volumes. Se, per esempio, il disco si chiama Archivio Mac, usa:

sudo mdutil -E "/Volumes/Archivio Mac"

Le virgolette sono necessarie quando il nome del volume contiene spazi. Per prima cosa puoi verificare i nomi dei volumi montati con:

ls /Volumes

La ricostruzione di un disco esterno non ricostruisce automaticamente l’indice del disco di avvio. Se entrambi i volumi presentano problemi, esegui il comando separatamente per ciascun percorso.

Come verificare che Spotlight stia indicizzando di nuovo

Dopo mdutil -E, macOS avvia il servizio di indicizzazione in background. Il Terminale non mostra sempre una percentuale di avanzamento, quindi l’assenza di un indicatore grafico non significa che il processo sia fermo.

Controlla nuovamente lo stato del volume:

mdutil -s /

Il messaggio dovrebbe indicare che l’indicizzazione è abilitata. Per osservare l’attività del sistema puoi aprire Monitoraggio Attività, cercare i processi mds e mdworker_shared e verificare se stanno utilizzando processore o disco. Questi processi appartengono a Spotlight e possono lavorare per un periodo variabile.

Puoi anche testare una ricerca dal Terminale con mdfind, che interroga direttamente l’indice Spotlight:

mdfind -onlyin "$HOME" "kMDItemFSName == '*.pdf'c"

Il comando cerca file PDF nella cartella utente. Se l’indice è ancora in ricostruzione, alcuni risultati possono mancare; ripeti il test dopo che l’attività di mds si è ridotta.

Se la ricerca continua a non funzionare, verifica che il file non sia dentro una cartella esclusa da Spotlight e che il volume sia montato normalmente. In caso di errori di autorizzazione, apri Impostazioni di Sistema > Privacy e sicurezza > Accesso completo al disco e aggiungi Terminale, quindi riapri l’applicazione e ripeti il comando. La disponibilità di questa autorizzazione e il nome esatto dei pannelli possono cambiare tra macOS Ventura, macOS Sonoma e macOS Sequoia.

Per un volume cifrato con FileVault, l’indice viene gestito sul volume avviato dopo l’autenticazione dell’utente. Non disattivare FileVault e non modificare le impostazioni di sicurezza soltanto per ricostruire l’indice Spotlight.

La procedura per ricostruire indice Spotlight macOS Terminale usa soltanto mdutil, non rimuove i dati e può risolvere rapidamente gli errori del catalogo di ricerca.

FAQ

No. mdutil -E / cancella e ricrea soltanto l’indice dei metadati di Spotlight; documenti, applicazioni e impostazioni restano invariati.

macOS non fornisce una durata fissa. Il tempo dipende dal numero di file, dal tipo di disco e dal carico del Mac; l’indicizzazione avviene in background.

sudo esegue il comando con privilegi amministrativi. La password non viene mostrata mentre la digiti, ma viene comunque acquisita dal Terminale.

Sì. Usa sudo mdutil -E "/Volumes/NomeVolume", sostituendo NomeVolume con il nome esatto del disco montato.

Verifica che il volume non sia escluso da Privacy di Spotlight, che il file si trovi in una posizione indicizzata e che mdutil -s / indichi l’indicizzazione attiva.

Altri articoli di questa serie: