Server LSP

OpenCode può integrarsi con server Language Server Protocol (LSP) per usare la diagnostica come feedback per l’agente.

Integrati

OpenCode include diversi server LSP integrati per linguaggi popolari:

LSP è disabilitato per impostazione predefinita. Quando è abilitato, i server si avviano quando viene rilevata una delle estensioni qui sopra e i requisiti sono soddisfatti.

Come funziona

Quando LSP è abilitato e opencode apre un file:

1. Controlla l’estensione del file rispetto a tutti i server LSP abilitati.
2. Avvia il server LSP appropriato se non e gia in esecuzione.

Buone pratiche

LSP può aiutare l’agente a trovare e correggere problemi fornendo diagnostica dai server di linguaggio. Questo è utile in alcuni progetti, ma non è sempre un vantaggio netto.

I server di linguaggio possono andare fuori sincronizzazione, usare molta memoria, variare in base alla versione o al progetto e rallentare i workflow dell’agente. In molti progetti è meglio far eseguire direttamente all’agente lint, typecheck o altri strumenti CLI diagnostici, così gli errori rientrano nel ciclo dell’agente senza questi compromessi. Documenta questi comandi nei file di istruzioni come AGENTS.md o nelle skills, così l’agente sa cosa eseguire. Abilita LSP quando il tuo progetto trae beneficio da feedback aggiuntivo del server di linguaggio.

Configura

Puoi abilitare e personalizzare i server LSP tramite la sezione lsp nella configurazione di opencode.

Per abilitare tutti i server LSP integrati, imposta lsp a true.

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

Usa un oggetto per mantenere abilitati i server integrati mentre configuri override o server personalizzati.

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

Ogni server LSP supporta i seguenti campi:

Vediamo alcuni esempi.

Variabili d’ambiente

Usa la proprieta env per impostare variabili d’ambiente quando avvii il server LSP:

{
  "$schema": "https://opencode.ai/config.json",
  "lsp": {
    "rust": {
      "env": {
        "RUST_LOG": "debug"
      }
    }
  }
}

Opzioni di inizializzazione

Usa la proprieta initialization per passare opzioni di inizializzazione al server LSP. Sono impostazioni specifiche del server inviate durante la richiesta LSP initialize:

{
  "$schema": "https://opencode.ai/config.json",
  "lsp": {
    "typescript": {
      "initialization": {
        "preferences": {
          "importModuleSpecifierPreference": "relative"
        }
      }
    }
  }
}

Disabilitare i server LSP

Se lsp è omesso, tutti i server LSP sono disabilitati. Per disabilitare tutti i server LSP dopo che un’altra configurazione li ha abilitati, imposta lsp a false:

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

Per disabilitare un server LSP specifico, imposta disabled a true:

{
  "$schema": "https://opencode.ai/config.json",
  "lsp": {
    "typescript": {
      "disabled": true
    }
  }
}

Server LSP personalizzati

Puoi aggiungere server LSP personalizzati specificando il comando e le estensioni file:

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

Informazioni aggiuntive

PHP Intelephense

PHP Intelephense offre funzionalita premium tramite una chiave di licenza. Puoi fornire la chiave inserendo (solo) la chiave in un file di testo in:

• Su macOS/Linux: $HOME/intelephense/license.txt
• Su Windows: %USERPROFILE%/intelephense/license.txt

Il file deve contenere solo la chiave di licenza, senza contenuti aggiuntivi.