nvimlspconfig

nvim-lspconfig

nvim-lspconfig es un repositorio de "solo datos" que proporciona configuraciones básicas y predeterminadas del cliente Nvim LSP para varios servidores LSP.

Vea la documentación de todas las configuraciones o :help lspconfig-all de Nvim.

Importante ⚠️

• Si encontró un error en la funcionalidad Nvim LSP ( :help lsp ), infórmelo al núcleo de Neovim.
  • No lo reportes aquí. Aquí solo viven los datos de configuración.
• Estas configuraciones son el mejor esfuerzo y cuentan con el respaldo de la comunidad. Ver contribuciones.
• Nota: este repositorio solo proporciona configuraciones . Su API programática está en desuso y no debe usarse externamente.
  • Se planea trabajar para actualizar selectivamente las partes del "marco" ( no las configuraciones) de nvim-lspconfig, al núcleo de Nvim, y desaprobarlas en nvim-lspconfig.

Instalar

• Requiere Nvim 0.9 superior. Actualice Nvim y nvim-lspconfig antes de informar un problema.
• Instale nvim-lspconfig usando la función "paquetes" de Vim:

   git clone https://github.com/neovim/nvim-lspconfig ~/.config/nvim/pack/nvim/start/nvim-lspconfig
  

• O utilice un administrador de complementos de terceros (consulte la documentación de su administrador de complementos).

Inicio rápido

1. Instalar un servidor de idiomas, por ejemplo, pyright

   npm i -g pyright

2. Agregue la configuración del servidor de idiomas a su init.lua.

    require ' lspconfig ' . pyright . setup {}

3. Asegúrese de que su proyecto/espacio de trabajo contenga un marcador raíz que coincida con los requisitos del servidor especificados en :help lspconfig-all .
4. Abra un archivo de código en Nvim. LSP adjuntará y proporcionará diagnósticos.

    nvim main.py
   

5. Ejecute :checkhealth lsp para ver el estado o solucionar problemas.

Lea :help lspconfig para obtener más detalles. Lea :help lspconfig-all para obtener la lista completa de detalles específicos del servidor. Para servidores que no están en su $PATH (por ejemplo, jdtls , elixirls ), debe configurar manualmente el parámetro cmd al llamar setup() .

Configuración

Nvim establece algunas opciones y asignaciones predeterminadas cuando un búfer se conecta a LSP (consulte :help lsp-config ). En particular:

• 'tagfunc'
  • Habilita las capacidades de "ir a definición" usando y otros comandos de etiquetas.
• 'omnifunc'
  • Habilita la finalización (manual) del modo omnidireccional con en el modo Insertar. Para completar automáticamente , se requiere un complemento de autocompletar.
• 'formatexpr'
  • Habilita el formateo LSP con gq .
• K se asigna a vim.lsp.buf.hover() en modo Normal.
• [d y ]d se asignan a vim.diagnostic.goto_prev() y vim.diagnostic.goto_next() , respectivamente.
• d se asigna a vim.diagnostic.open_float() .

Se puede lograr una mayor personalización utilizando el evento de comando automático LspAttach . El evento de comando automático LspDetach se puede utilizar para "limpiar" asignaciones si un búfer se desconecta de un servidor LSP. Consulte :h LspAttach y :h LspDetach para obtener detalles y ejemplos. Consulte :h lsp-buf para obtener detalles sobre otras funciones de LSP.

Se pueden proporcionar opciones de configuración adicionales para cada servidor LSP pasando argumentos a la función setup . Consulte :h lspconfig-setup para obtener más detalles. Ejemplo:

 local lspconfig = require ( ' lspconfig ' )
lspconfig . rust_analyzer . setup {
  -- Server-specific settings. See `:help lspconfig-setup`
  settings = {
    [ ' rust-analyzer ' ] = {},
  },
}

Solución de problemas

Las razones más comunes por las que un servidor de idiomas no se inicia ni se conecta son:

1. El servidor de idiomas no está instalado. nvim-lspconfig no instala servidores de idiomas por usted. Debería poder ejecutar el cmd definido en el módulo Lua de cada servidor desde la línea de comando y ver que se inicia el servidor de idiomas. Si cmd es un nombre ejecutable en lugar de una ruta absoluta al ejecutable, asegúrese de que esté en su ruta.
2. Faltan complementos de tipo de archivo. Vim/Nvim no detecta ciertos idiomas porque aún no se han agregado al sistema de detección de tipos de archivos. Asegúrese de :set ft? muestra el tipo de archivo y no un valor vacío.
3. No activa la detección de raíz. Algunos servidores de idiomas solo se iniciarán si se abren en un directorio, o directorio secundario, que contenga un archivo que indique la raíz del proyecto. La mayoría de las veces, esta es una carpeta .git , pero cada servidor define la configuración raíz en el archivo lua. Consulte doc/configs.md o la fuente para obtener la lista de directorios raíz.
4. Debe pasar capabilities para cada setup {} si desea que surtan efecto.
5. No llame setup {} dos veces para el mismo servidor . La segunda llamada a setup {} sobrescribirá la primera.

Informes de errores

Si encontró un error con la funcionalidad LSP, infórmelo al núcleo de Neovim.

Antes de informar un error, verifique sus registros y la salida de :LspInfo . Agregue lo siguiente a su init.vim para habilitar el registro:

 vim . lsp . set_log_level ( " debug " )

Intente ejecutar el servidor de idiomas y abra el registro con:

 :LspLog

La mayoría de las veces, el motivo del error está presente en los registros.

Comandos

• :LspInfo (alias en desuso de :che lspconfig ) muestra el estado de los servidores de idiomas activos y configurados.
• :LspStart Inicia el nombre del servidor solicitado. Solo se iniciará correctamente si el comando detecta un directorio raíz que coincida con la configuración actual. Pase autostart = false a su llamada .setup{} para un servidor de idioma si desea iniciar clientes únicamente con este comando. El valor predeterminado es todos los servidores que coincidan con el tipo de archivo del búfer actual.
• :LspStop De forma predeterminada, detiene todos los clientes del búfer.
• :LspRestart El valor predeterminado es reiniciar todos los clientes del búfer.

Contribuciones

Si falta un servidor de idioma en configs.md, contribuir con una nueva configuración ayuda a otros, especialmente si el servidor requiere una configuración especial. Siga estos pasos:

1. Lea CONTRIBUTING.md.
2. Cree un nuevo archivo en lua/lspconfig/configs/SERVER_NAME.lua .
   • Copie una configuración existente para comenzar. La mayoría de las configuraciones son simples. Para ver un ejemplo completo, consulte texlab.lua.
3. Haga preguntas en las discusiones de GitHub o en la sala Neovim Matrix.

Proceso de liberación

Para publicar un comunicado:

• Crea y envía una nueva etiqueta.
• Después de presionar la etiqueta, una acción de GitHub empaquetará automáticamente el complemento y publicará la versión en LuaRocks.

Licencia

Copyright de los contribuyentes de Neovim. Reservados todos los derechos.

nvim-lspconfig tiene licencia según los términos de la licencia Apache 2.0.

Ver LICENCIA.md