Configuración del servidor LSP de OpenCode

OpenCode se integra profundamente con el Protocolo de Servidor de Lenguaje (LSP, Language Server Protocol), proporcionando retroalimentación en tiempo real, como diagnósticos de código y avisos de errores, al LLM a través del servidor LSP, lo que ayuda a la IA a comprender y manipular tu base de código con mayor precisión.

En términos simples, el servidor LSP es el componente que le da a OpenCode la capacidad de "entender el código", similar a los complementos de VS Code que ofrecen autocompletado y avisos de errores. Cuando ocurren errores de sintaxis o desajustes de tipos en un archivo, el servidor LSP retroalimenta esa información de diagnóstico al LLM, permitiéndole realizar modificaciones más precisas.

Cómo funciona

La integración de LSP en OpenCode es totalmente automática, sin necesidad de intervención manual. Cuando OpenCode abre un archivo, se ejecuta el siguiente proceso en orden:

打开文件
  │
  ▼
读取文件扩展名（如 .ts、.py、.go）
  │
  ▼
与所有已启用的 LSP 服务器进行匹配
  │
  ├── 匹配成功且服务器已运行 → 直接使用
  │
  └── 匹配成功但服务器未运行 → 自动启动对应 LSP 服务器

Todo el proceso se completa silenciosamente en segundo plano. Una vez iniciado, el servidor LSP proporciona continuamente información de diagnóstico para la sesión actual.

Servidores LSP integrados

OpenCode incluye soporte integrado para servidores LSP de los principales lenguajes,cuando se detecta la extensión de archivo correspondiente y se cumplen los requisitos pertinentes, el servidor LSP se habilita automáticamente, y en la mayoría de los casos no se requiere configuración alguna.

Si no deseas que OpenCode descargue automáticamente el servidor LSP, puedes configurar la variable de entornoOPENCODE_DISABLE_LSP_DOWNLOADestableciéndola entruepara deshabilitar la descarga automática. Consulta las notas al final para más detalles.

Configurar el servidor LSP

La configuración relacionada con LSP se escribe en el campoopencode.jsondelsp. En la mayoría de los casos no se necesita configuración, LSP se habilita automáticamente; pero cuando se requiere personalizar el comportamiento, cada servidor LSP admite los siguientes elementos de configuración:

1. Establecer variables de entorno (env)

Usaenvla propiedad para inyectar variables de entorno al iniciar el servidor LSP. Se usa a menudo para activar registros de depuración o especificar rutas requeridas en tiempo de ejecución:

2. Establecer opciones de inicialización (initialization)

initializationSe utiliza para transmitir configuraciones específicas del servidor al servidor LSP. Estas opciones se envían de una sola vez durante la negociación (handshake) de LSP (initializesolicitud) y afectan todo el comportamiento posterior de ese servidor:

Las opciones de inicialización varían según el servidor LSP. Por ejemplo,typescriptlas opciones de un servidor y otrogoplsson completamente diferentes. Antes de usarlas, consulta la documentación oficial del servidor LSP correspondiente para evitar enviar configuraciones no válidas.

Deshabilitar el servidor LSP

1. Deshabilitar todos los servidores LSP

Si no necesitas la funcionalidad de LSP en absoluto, puedes establecerlspglobalmente comofalse, lo que desactiva todos los servidores LSP de una sola vez:

2. Deshabilitar un servidor LSP específico

Si solo deseas desactivar un servidor LSP específico y conservar los demás, establece individualmente para ese servidordisabled: true：

Agregar un servidor LSP personalizado

Si el lenguaje que usas no está en la lista de soporte integrado, puedes especificarcommandyextensionspara agregar manualmente cualquier servidor LSP, siempre que ese servidor siga el protocolo LSP estándar y admita el--stdiomodo (comunicación a través de la entrada/salida estándar) es suficiente:

También puedes configurar variables de entorno y opciones de inicialización para el servidor LSP personalizado, exactamente de la misma manera que con los servidores integrados:

Notas adicionales

Licencia de PHP Intelephense

PHP Intelephense ofrece una versión gratuita y una versión premium de pago. La versión premium se desbloquea mediante una clave de licencia e incluye funciones mejoradas como organización de importaciones, plegado de código, visualización de jerarquía de llamadas, etc. Si ha comprado una licencia, simplemente escriba la clave en un archivo de texto en la siguiente ruta para activarla automáticamente, sin necesidad de configuración adicional:

El archivo de licencia solo debe contener la clave de licencia en sí. No agregue ningún otro contenido (incluidos espacios o saltos de línea adicionales), de lo contrario la activación puede fallar.

Deshabilitar la descarga automática

De forma predeterminada, OpenCode descarga automáticamente el servidor LSP necesario desde la red cuando detecta la extensión de archivo correspondiente. Si se encuentra en un entorno con restricciones de red o prefiere gestionar las herramientas LSP completamente de forma manual, puede deshabilitar la descarga automática configurando las siguientes variables de entorno:

# Linux / macOS：临时禁用（仅当前终端会话有效）
export OPENCODE_DISABLE_LSP_DOWNLOAD=true

# Linux / macOS：永久禁用（写入 shell 配置文件）
echo 'export OPENCODE_DISABLE_LSP_DOWNLOAD=true' >> ~/.bashrc
source ~/.bashrc

# Windows（PowerShell：仅当前会话）
$env:OPENCODE_DISABLE_LSP_DOWNLOAD = "true"

Una vez deshabilitado, OpenCode ya no descargará automáticamente ningún servidor LSP, pero las herramientas LSP preinstaladas en el sistema aún pueden detectarse y utilizarse con normalidad.