troubleshooting

Espanso non funziona? 8 soluzioni comuni (2026)

Trofin Sorin-IoanTrofin Sorin-IoanCTO, Lightning Assist29 marzo 20268 min di lettura
espansotext-expandertroubleshootinglinuxwindowsmacos
Condividi:
Immagine in primo piano del post del blog Lightning Assist

Espanso è un potente espansore di testo open source, ma la sua configurazione basata su YAML significa che le cose possono andare storte in modi non ovvi. Ecco i motivi più comuni per cui Espanso smette di funzionare e come risolverli. Per la CLI e i percorsi ufficiali, consulta la Espanso documentazione.

1. Espanso non è in esecuzione

La causa più comune: il servizio Espanso non è avviato.

Correzione:

espanso start

Controlla se è in esecuzione:

espanso status

Su Linux con systemd:

systemctl --user status espanso
systemctl --user start espanso

2. YAML Errore di sintassi nella configurazione

Espanso fallisce silenziosamente quando un file di configurazione ha YAML non valido. Una scheda o due punti fuori posto interrompe l'intero file.

Correzione: Esegui il config doctor:

espanso doctor

Errori comuni da controllare:

  • Utilizzo di tabulazioni anziché spazi (YAML richiede spazi)
  • Virgolette mancanti attorno al testo che contiene caratteri speciali come :, # o \
  • Rientro spostato di uno spazio
  • Un valore replace: che inizia con { — deve essere racchiuso tra virgolette: replace: "{{clipb}}"

3. Espanso Non funziona in un'applicazione specifica

Alcune applicazioni, in particolare le app Electron (VS Code, Slack, Discord), terminali e app con gestione dell'input personalizzata, non ricevono correttamente le sequenze di tasti simulate di Espanso.

Correzione su Linux: Assicurati di utilizzare il backend di injection corretto. Modifica ~/.config/espanso/config/default.yml:

backend: Auto

Prova a cambiare tra Auto, Clipboard e Inject:

backend: Clipboard

Correzione su Windows: esegui Espanso come amministratore, in particolare per le app eseguite con privilegi elevati.

Correzione su macOS: Vai a Impostazioni di sistema → Privacy e sicurezza → Accessibilità, rimuovi Espanso dall'elenco, quindi aggiungilo di nuovo.

4. Autorizzazioni di accessibilità mancanti (macOS)

Senza autorizzazioni di accessibilità, Espanso non può monitorare le sequenze di tasti o simulare l'output di testo.

Correzione:

  1. Apri Impostazioni di sistema → Privacy e sicurezza → Accessibilità
  2. Trova Espanso nell'elenco
  3. Disattivalo, quindi riattivalo
  4. Riavvia Espanso: espanso restart

5. Il grilletto non si attiva: tipo di grilletto errato

Per impostazione predefinita, Espanso utilizza trigger di parole che si espandono solo dopo un separatore di parole (spazio, nuova riga, punteggiatura). Se stai digitando il tuo trigger nel mezzo di una parola, non si espanderà.

Correzione: controlla il tipo di trigger nel file di corrispondenza. Utilizza word: false se vuoi attivarlo ovunque:

matches:
  - trigger: ":sig"
    replace: "Best regards,\nYour Name"
    word: false

Oppure utilizza il tipo di trigger regex per un maggiore controllo:

matches:
  - regex: ":sig$"
    replace: "Best regards,\nYour Name"

6. Espanso Non funziona dopo l'aggiornamento del sistema

Gli aggiornamenti del sistema operativo, in particolare su macOS e Linux, spesso revocano le autorizzazioni di accessibilità o interrompono il servizio di sistema.

Correzione:

  1. Concedere nuovamente le autorizzazioni di accessibilità (vedere la correzione 4 per macOS)
  2. Il Linux, registra nuovamente il servizio systemd: espanso service register
  3. Su Windows, controlla che Espanso sia ancora nell'elenco di avvio

7. File di configurazione nella posizione errata

Espanso cerca i file di configurazione in posizioni specifiche. Se inserisci i file delle partite .yml nella cartella sbagliata, non verranno mai caricati.

Posizioni di configurazione predefinite:

  • Linux: ~/.config/espanso/
  • macOS: ~/Library/Application Support/espanso/
  • Windows: %APPDATA%\espanso\

I file delle corrispondenze devono trovarsi nella sottodirectory match/. Esegui espanso path per vedere i percorsi esatti per il tuo sistema.

8. Espanso È in conflitto con un'altra applicazione

Alcune applicazioni o strumenti di accessibilità registrano tasti di scelta rapida globali che sono in conflitto con il monitoraggio dei tasti di Espanso.

Correzione:

  • Disattiva temporaneamente altri strumenti di accessibilità, lettori di schermo o gestori di tasti di scelta rapida
  • Controlla la presenza di errori nei log Espanso: espanso log
  • Prova a eseguire espanso doctor per una diagnostica completa

Ancora non funziona? Controlla i registri

espanso log

Questo mostra esattamente perché Espanso non funziona. Cerca errori di autorizzazione, errori di analisi o problemi di backend.

Quando la configurazione di Espanso diventa un onere di manutenzione

La configurazione YAML di Espanso ti dà potenza ma aggiunge reale attrito, soprattutto quando inizi, esegui il debug di errori silenziosi o collabori con un team che non è a suo agio con i file di configurazione.

Se dedichi più tempo a correggere Espanso che a utilizzarlo effettivamente, prendi in considerazione Lightning Assist: un espansore di testo grafico per Windows, Mac e Linux con una GUI completa, comandi AI integrati, digitazione vocale push-to-talk e condivisione di snippet del team. Nessun file di configurazione. Scarica la prova gratuita di 14 giorni: non è richiesta la carta di credito.

Per un confronto dettagliato, vedi Lightning Assist vs Espanso.

Articoli correlati