OpenCode LSP: cosa fa, come abilitarlo e correggere i server disattivati

LSP significa Language Server Protocol. Un server di linguaggio gira accanto al progetto e fornisce diagnostica, simboli, definizioni, riferimenti e informazioni hover. OpenCode può usare questi dati nella sessione invece di trattare ogni file come testo isolato.

Il vantaggio pratico è il contesto. Se il server TypeScript comprende un import, l’agente dispone di più prove per spiegare un errore di tipo o un rename. LSP però non garantisce una risposta corretta: il server può mancare, il progetto può non caricarsi o il pacchetto può richiedere configurazione propria. Non sostituisce test e revisione del diff.

Una voce LSP richiede un comando eseguibile e un rapporto chiaro con le estensioni. Il comando avvia il server e l’elenco delle estensioni indica quali file usare. Eseguibile, argomenti e installazione dipendono dalla documentazione del server: non indovinare il pacchetto.

Inizia con una lingua in un piccolo repository. Apri un file con l’estensione prevista, verifica l’avvio del processo e fai una richiesta di sola lettura. Se l’estensione non coincide, un server valido può sembrare rotto perché OpenCode non lo collega al file.

Metti le decisioni condivise in una configurazione di progetto revisionata. Tieni gli esperimenti personali nella configurazione globale finché comando, estensioni e root sono chiari. La guida JSONC tratta ambito e Schema; questa pagina resta sul server di linguaggio.

Una voce piccola è più semplice da diagnosticare di un catalogo ampio. Usa un nome descrittivo, un array di comandi esplicito e solo le estensioni supportate. Aggiungi l’inizializzazione dopo il processo base. JSON valido non prova che eseguibile o workspace siano corretti.

{
  "$schema": "https://opencode.ai/config.json",
  "lsp": {
    "typescript": {
      "command": ["typescript-language-server", "--stdio"],
      "extensions": [".ts", ".tsx"]
    }
  }
}

La documentazione ufficiale attuale dice che omettere lsp disabilita tutti i server. Per disabilitarli tutti dopo un’altra configurazione usa lsp: false; per un server usa disabled: true. È utile se il server è lento, rumoroso o incompatibile.

I server personalizzati coprono linguaggi o estensioni non presenti nella configurazione comune. Definisci prima comando ed estensioni, aggiungi l’inizializzazione secondo i docs e cambia una cosa per volta. Conserva l’ultima configurazione funzionante per il rollback.

{
  "$schema": "https://opencode.ai/config.json",
  "lsp": false
}

{
  "$schema": "https://opencode.ai/config.json",
  "lsp": {
    "custom-lsp": {
      "command": ["custom-lsp-server", "--stdio"],
      "extensions": [".custom"],
      "initialization": { "preferences": { "mode": "strict" } }
    }
  }
}

Non iniziare riscrivendo un modulo grande. Usa un repository pulito, apri un file noto e chiedi una lettura: simbolo, definizione o diagnostica. Confronta il risultato con editor, compilatore o server già affidabile.

Dopo il test, fai una modifica piccola e reversibile e controlla il diff. Registra sistema, comando, estensioni, root e prompt. La nota rende il test riproducibile e il prossimo problema più facile da classificare.

1. PulireParti da branch e albero di lavoro conosciuti.
2. AssociareApri un file con estensione configurata.
3. LeggereChiedi simbolo, definizione, riferimento o diagnostica.
4. ModificareFai una modifica reversibile e controlla il diff.
5. RegistrareSalva comando, modello, server e rollback.

Se OpenCode dice che gli LSP sono disabilitati, controlla prima la precedenza. Un altro file può imporre lsp: false, il progetto può non dichiarare il server o una voce può avere disabled. Confronta la cartella del progetto con la configurazione effettiva.

Se il server è attivo ma non arrivano diagnostici, controlla comando ed estensione. Avvialo nella stessa shell, verifica runtime e PATH e controlla lockfile, configurazione del compilatore e root del workspace. Un primo risultato lento può essere indicizzazione.

Mantieni stretti i permessi. LSP richiede processo e contesto di progetto, non shell ampia, più tool MCP o approvazione automatica. Usa le manuali sui permessi e MCP quando il problema cambia livello.

LSP fornisce intelligenza di linguaggio nel repository. MCP collega tool e dati esterni. Il formatter modifica lo stile e i test danno evidenza eseguibile. VS Code può mostrare la propria diagnostica; ciò non dimostra che OpenCode usi lo stesso server o root.

Usa la guida adatta: MCP per server locali e remoti, VS Code per contesto editor e terminale, permissions per le approvazioni. Così la pagina LSP in OpenCode resta focalizzata.