Servidores LSP

OpenCode se integra con tus servidores LSP.

OpenCode puede integrarse con tu Language Server Protocol (LSP) para ayudar al LLM a interactuar con tu base de código. Usa los diagnósticos para proporcionar retroalimentación al LLM.

Integrados

OpenCode incluye varios servidores LSP integrados para lenguajes populares:

Cuando LSP está habilitado, los servidores se inician cuando se detecta una de las extensiones de archivo anteriores y se cumplen los requisitos.

Nota: Puedes deshabilitar las descargas automáticas de servidores LSP estableciendo la variable de entorno OPENCODE_DISABLE_LSP_DOWNLOAD en true.

Cómo funciona

Cuando LSP está habilitado y opencode abre un archivo:

1. Comprueba la extensión del archivo contra todos los servidores LSP habilitados.
2. Inicia el servidor LSP apropiado si no se está ejecutando ya.

Configuración

Puedes habilitar y personalizar los servidores LSP mediante la sección lsp en tu configuración de opencode.

Para habilitar todos los servidores LSP integrados, establece lsp en true.

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

Usa un objeto para mantener los integrados habilitados mientras configuras anulaciones o servidores personalizados.

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

Cada entrada de servidor LSP configurada admite lo siguiente:

Las entradas de servidor necesitan command a menos que solo deshabiliten un servidor.

Veamos algunos ejemplos.

Variables de entorno

Usa la propiedad env para establecer variables de entorno al iniciar el servidor LSP:

{
  "$schema": "https://opencode.ai/config.json",
  "lsp": {
    "rust": {
      "command": ["rust-analyzer"],
      "env": {
        "RUST_LOG": "debug"
      }
    }
  }
}

Opciones de inicialización

Usa la propiedad initialization para pasar opciones de inicialización al servidor LSP. Estos son ajustes específicos del servidor que se envían durante la solicitud initialize de LSP:

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

Nota: Las opciones de inicialización varían según el servidor LSP. Consulta la documentación de tu servidor LSP para conocer las opciones disponibles.

Deshabilitar servidores LSP

Si se omite lsp, todos los servidores LSP están deshabilitados. Para deshabilitar todos los servidores LSP después de que otra configuración los haya habilitado, establece lsp en false:

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

Para deshabilitar un servidor LSP específico, establece disabled en true:

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

Servidores LSP personalizados

Puedes agregar servidores LSP personalizados especificando el comando y las extensiones de archivo:

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

Información adicional

PHP Intelephense

PHP Intelephense ofrece funciones premium mediante una clave de licencia. Puedes proporcionar una clave de licencia colocando (solo) la clave en un archivo de texto en:

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

El archivo debe contener únicamente la clave de licencia, sin contenido adicional.