Espanso non funziona? 9 soluzioni comuni (2026)

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.

Trasparenza: sviluppiamo Lightning Assist, un espansore di testo a pagamento, quindi Espanso è un nostro concorrente. Espanso è gratuito e open source, e ogni soluzione qui sotto riguarda Espanso stesso: nessuna richiede di cambiare strumento.

Aggiornato il 7 settembre 2026: la soluzione #9 è stata riscritta per Espanso 2.4.1 e Ubuntu 26.04, che non include più una sessione X11.

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}}"

Se gli errori silenziosi YAML sono un problema ricorrente per il tuo team, un editor di snippet basato su GUI elude completamente il problema: modifichi i campi in un modulo invece di convalidare il rientro a occhio.

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

Questa danza di reimpostazione dei permessi è comune dopo ogni rilascio di punti macOS. Se preferisci non ripeterlo, guarda come Lightning Assist gestisce le macOS autorizzazioni (la concessione singola sopravvive agli aggiornamenti di sistema).

💡 Passi più tempo a riparare Espanso che a usarlo? Lightning Assist è un espansore di testo grafico senza file YAML, comandi AI integrati e lo stesso supporto Linux. Prova gratuita per 14 giorni → — nessuna carta di credito.

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

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

Per impostazione predefinita, i tuoi snippet si espandono mentre scrivi — nessuna scorciatoia necessaria: Lightning Assist viene fornito con la modalità As-You-Type Mode attivata. Digita il trigger del tuo snippet — il testo esatto che hai salvato, ad esempio ;meeting o meeting — e si espande inline nel momento in cui finisci di digitarlo. Un ; iniziale è facoltativo e mantiene i trigger distinti dalle parole normali. Preferisci un attivatore deliberato? Passa in qualsiasi momento alla modalità Hotkey Mode (opzionale). Vedi tutte le modalità di attivazione →

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

9. Espanso non si avvia su Wayland

Nelle sessioni Wayland (il default su Ubuntu, Fedora e ogni attuale desktop GNOME), Espanso necessita della sua build dedicata per Wayland e di un permesso una tantum sul binario; senza uno dei due non si avvia o si avvia ma non espande mai (issue #2223).

Soluzione: Controlla il tipo di sessione con echo $XDG_SESSION_TYPE. Se restituisce wayland:

1. Installa il pacchetto specifico per Wayland (espanso-debian-wayland-amd64.deb su Debian/Ubuntu, il Terra RPM su Fedora), non quello per X11.
2. Concedi la capacità che Espanso necessita per leggere /dev/input e scrivere su /dev/uinput: sudo setcap "cap_dac_override+p" $(which espanso). Questo è il passaggio nella guida di installazione Linux di Espanso. Le capacità del file sono legate al binario stesso, quindi se l’espansione si blocca dopo un aggiornamento di Espanso, esegui di nuovo questo comando.
3. Esegui espanso service register e espanso start.

Assicurati di usare Espanso 2.4.0 o successivo (2.4.0 rilasciato il 21 luglio 2026, 2.4.1 il 2 settembre 2026). La 2.4.0 ha aggiunto il rilevamento delle app per i compositor wlroots (Sway, Hyprland, labwc, Wayfire) e ha risolto un errore di installazione nella sessione Wayland di Fedora; la 2.4.1 ha aggiunto il file desktop e l’icona su Linux. Tuttavia, la guida di installazione di Espanso definisce ancora il supporto Wayland “sperimentale”: le tastiere con layout non US devono essere configurate a mano, i match specifici per app funzionano solo su KDE con kdotool installato, GNOME mostra un piccolo sfarfallio con il backend clipboard, e una tastiera appena collegata richiede espanso restart.

Una novità del 2026: “basta accedere a una sessione X11” non è più un’opzione su GNOME. GNOME 50 ha rimosso completamente la sessione X11, quindi Ubuntu 26.04 LTS — e qualsiasi altra distribuzione con GNOME 50 — è solo Wayland (le app X11 girano ancora tramite XWayland, ma la build X11 di Espanso non vede le battute da app native Wayland). Se l’espansione su Wayland resta inaffidabile, le opzioni rimaste sono un compositor che Espanso gestisce bene (KDE o uno wlroots) oppure un text expander il cui supporto Wayland non è sperimentale — vedi la nostra guida all’espansione testo su Wayland.

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.

In breve: Espanso vs Lightning Assist

Caratteristica	Espanso	Lightning Assist
Fonte aperta	✅	❌ (commerciale, prova di 14 giorni)
Prezzi	Gratuito / donazioni	Gratuito (fino a 20 snippet, cartelle e un team); Pro 5,99 $/mese. Funzionalità AI misurate tramite crediti AI (1000 al mese inclusi con Pro, acquistati in base alle esigenze nel piano gratuito).
Multipiattaforma (Windows, macOS, Linux)	✅	✅
Configurazione	YAML file	Editor grafico
Comandi AI (riscrivi, migliora, ecc.)	❌	✅ — crediti IA, senza abbonamento
Push-to-talk da voce a testo	❌	✅ — funziona anche nel livello gratuito, consuma crediti AI
Condivisione dello snippet del team	❌ (soluzioni alternative della community)	✅ integrato
Esperienza di debug	CLI (espanso doctor, registri)	Pannello di stato della GUI

Entrambi spediscono il Windows, macOS e Linux. La scelta di solito si riduce a: preferisci CLI + file di configurazione + gratis (Espanso) o GUI + AI + voce + a pagamento (Lightning Assist).

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 risolvere Espanso che a usarlo 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 snippet del team condivisione. Nessun file di configurazione, nessun YAML. Scarica la prova gratuita di 14 giorni: non è richiesta la carta di credito.

Per un confronto dettagliato, vedi Lightning Assist vs Espanso.