mirror of
https://gitea.toothfairyai.com/ToothFairyAI/tf_code.git
synced 2026-04-05 08:33:10 +00:00
189 lines
9.5 KiB
Plaintext
189 lines
9.5 KiB
Plaintext
---
|
|
title: LSP Servidores
|
|
description: OpenCode se integra con sus servidores LSP.
|
|
---
|
|
|
|
OpenCode se integra con su protocolo de servidor de idiomas (LSP) para ayudar a LLM a interactuar con su código base. Utiliza diagnósticos para proporcionar retroalimentación al LLM.
|
|
|
|
---
|
|
|
|
## Incorporado
|
|
|
|
OpenCode viene con varios servidores LSP integrados para idiomas populares:
|
|
|
|
| LSP Servidor | Extensiones | Requisitos |
|
|
| ------------------ | ------------------------------------------------------------------- | ------------------------------------------------------------------------ |
|
|
| astro | .astro | Autoinstalaciones para proyectos Astro |
|
|
| fiesta | .sh, .bash, .zsh, .ksh | Autoinstala el servidor en lenguaje bash |
|
|
| sonido metálico | .c, .cpp, .cc, .cxx, .c++, .h, .hpp, .hh, .hxx, .h++ | Instalaciones automáticas para proyectos C/C++ |
|
|
| csostenido | .cs | `.NET SDK` instalado |
|
|
| clojure-lsp | .clj, .cljs, .cljc, .edn | Comando `clojure-lsp` disponible |
|
|
| dardo | .dardo | Comando `dart` disponible |
|
|
| deno | .ts, .tsx, .js, .jsx, .mjs | Comando `deno` disponible (detecta automáticamente deno.json/deno.jsonc) |
|
|
| elixir-ls | .ex, .exs | Comando `elixir` disponible |
|
|
| eslint | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts, .vue | `eslint` dependencia en proyecto |
|
|
| f sostenido | .fs, .fsi, .fsx, .fsscript | `.NET SDK` instalado |
|
|
| brillo | .brillo | Comando `gleam` disponible |
|
|
| gopls | .ir | Comando `go` disponible |
|
|
| hls | .hs, .lhs | Comando `haskell-language-server-wrapper` disponible |
|
|
| jdtls | .java | `Java SDK (version 21+)` instalado |
|
|
| kotlin-ls | .kt, .kts | Autoinstalaciones para proyectos Kotlin |
|
|
| lua-ls | .lua | Autoinstalaciones para proyectos Lua |
|
|
| nada | .nix | Comando `nixd` disponible |
|
|
| ocaml-lsp | .ml, .mli | Comando `ocamllsp` disponible |
|
|
| oxlint | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts, .vue, .astro, .svelte | `oxlint` dependencia en proyecto |
|
|
| php intelefense | .php | Autoinstalaciones para proyectos PHP |
|
|
| prisma | .prisma | Comando `prisma` disponible |
|
|
| derechos de autor | .py, .pyi | Dependencia `pyright` instalada |
|
|
| rubí-lsp (rubocop) | .rb, .rake, .gemspec, .ru | Comandos `ruby` y `gem` disponibles |
|
|
| óxido | .rs | Comando `rust-analyzer` disponible |
|
|
| kit de fuente-lsp | .swift, .objc, .objcpp | `swift` instalado (`xcode` en macOS) |
|
|
| esbelto | .esbelto | Autoinstalaciones para proyectos Svelte |
|
|
| terraformar | .tf, .tfvars | Instalaciones automáticas desde versiones GitHub |
|
|
| diminuto | .tipo, .tipo | Instalaciones automáticas desde versiones GitHub |
|
|
| mecanografiado | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts | `typescript` dependencia en proyecto |
|
|
| vista | .vue | Autoinstalaciones para proyectos Vue |
|
|
| yaml-ls | .yaml, .yml | Autoinstala Red Hat yaml-language-server |
|
|
| zls | .zig, .zon | Comando `zig` disponible |
|
|
|
|
Los servidores LSP se habilitan automáticamente cuando se detecta una de las extensiones de archivo anteriores y se cumplen los requisitos.
|
|
|
|
:::nota
|
|
Puede deshabilitar las descargas automáticas del servidor LSP configurando la variable de entorno `OPENCODE_DISABLE_LSP_DOWNLOAD` en `true`.
|
|
:::
|
|
|
|
---
|
|
|
|
## Cómo funciona
|
|
|
|
Cuando opencode abre un archivo,:
|
|
|
|
1. Comprueba la extensión del archivo con todos los servidores LSP habilitados.
|
|
2. Inicia el servidor LSP apropiado si aún no se está ejecutando.
|
|
|
|
---
|
|
|
|
## Configurar
|
|
|
|
Puede personalizar los servidores LSP a través de la sección `lsp` en su configuración opencode.
|
|
|
|
```json title="opencode.json"
|
|
{
|
|
"$schema": "https://opencode.ai/config.json",
|
|
"lsp": {}
|
|
}
|
|
```
|
|
|
|
Cada servidor LSP admite lo siguiente:
|
|
|
|
| Propiedad | Tipo | Descripción |
|
|
| ---------------- | -------- | ------------------------------------------------------------ |
|
|
| `disabled` | booleano | Establezca esto en `true` para deshabilitar el servidor LSP |
|
|
| `command` | cadena[] | El comando para iniciar el servidor LSP |
|
|
| `extensions` | cadena[] | Extensiones de archivo que este servidor LSP debería manejar |
|
|
| `env` | objeto | Variables de entorno para configurar al iniciar el servidor |
|
|
| `initialization` | objeto | Opciones de inicialización para enviar al servidor LSP |
|
|
|
|
Veamos algunos ejemplos.
|
|
|
|
---
|
|
|
|
### Variables de entorno
|
|
|
|
Utilice la propiedad `env` para establecer variables de entorno al iniciar el servidor LSP:
|
|
|
|
```json title="opencode.json" {5-7}
|
|
{
|
|
"$schema": "https://opencode.ai/config.json",
|
|
"lsp": {
|
|
"rust": {
|
|
"env": {
|
|
"RUST_LOG": "debug"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
### Opciones de inicialización
|
|
|
|
Utilice la propiedad `initialization` para pasar opciones de inicialización al servidor LSP. Estas son configuraciones específicas del servidor enviadas durante la solicitud LSP `initialize`:
|
|
|
|
```json title="opencode.json" {5-9}
|
|
{
|
|
"$schema": "https://opencode.ai/config.json",
|
|
"lsp": {
|
|
"typescript": {
|
|
"initialization": {
|
|
"preferences": {
|
|
"importModuleSpecifierPreference": "relative"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
:::nota
|
|
Las opciones de inicialización varían según el servidor LSP. Consulte la documentación de su servidor LSP para conocer las opciones disponibles.
|
|
:::
|
|
|
|
---
|
|
|
|
### Deshabilitar servidores LSP
|
|
|
|
Para deshabilitar **todos** los servidores LSP globalmente, configure `lsp` en `false`:
|
|
|
|
```json title="opencode.json" {3}
|
|
{
|
|
"$schema": "https://opencode.ai/config.json",
|
|
"lsp": false
|
|
}
|
|
```
|
|
|
|
Para deshabilitar un servidor LSP **específico**, configure `disabled` en `true`:
|
|
|
|
```json title="opencode.json" {5}
|
|
{
|
|
"$schema": "https://opencode.ai/config.json",
|
|
"lsp": {
|
|
"typescript": {
|
|
"disabled": true
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
### Servidores LSP personalizados
|
|
|
|
Puede agregar servidores LSP personalizados especificando el comando y las extensiones de archivo:
|
|
|
|
```json title="opencode.json" {4-7}
|
|
{
|
|
"$schema": "https://opencode.ai/config.json",
|
|
"lsp": {
|
|
"custom-lsp": {
|
|
"command": ["custom-lsp-server", "--stdio"],
|
|
"extensions": [".custom"]
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
## Información adicional
|
|
|
|
### PHP Intelefense
|
|
|
|
PHP Intelephense ofrece funciones premium a través de una clave de licencia. Puede proporcionar una clave de licencia colocando (únicamente) la clave en un archivo de texto en:
|
|
|
|
- El macOS/Linux: `$HOME/intelephense/licence.txt`
|
|
- El Windows: `%USERPROFILE%/intelephense/licence.txt`
|
|
|
|
El archivo debe contener sólo la clave de licencia sin contenido adicional.
|