Un archivo TypeScript abre correctamente, el resaltado tiene colores y la búsqueda encuentra símbolos. Sin embargo, «ir a definición» no responde, el autocompletado ofrece candidatos distintos de los diagnósticos y el test runner funciona solo desde otra ventana. La tentación es instalar otro plugin. El problema más útil de resolver es anterior: ¿qué parte del entorno produce cada capacidad y qué contrato la conecta con las demás?
Neovim puede ser el centro de un entorno de desarrollo completo, pero no es un compilador, un servidor de lenguajes, un depurador ni un gestor de proyectos por sí mismo. Es un editor modal, extensible mediante Lua y APIs de eventos, capaz de coordinar procesos externos. Esa separación permite construir una estación de trabajo auditable; también explica por qué una configuración copiada sin entender sus dependencias puede fallar silenciosamente.
La referencia de versiones para este análisis es Neovim 0.12, cuya versión estable 0.12.6 se publicó en octubre de 2026. El ejemplo de integración LSP usa la API incorporada desde 0.11. No describe dotfiles del autor ni pretende ser una configuración completa de LazyVim.
Primero, el modelo del editor: buffer, ventana y pestaña
En Neovim, un buffer representa texto cargado en memoria y su estado de edición. Una window es una vista de un buffer: tiene posición, cursor, tamaño y opciones de presentación. Una tabpage organiza una disposición de ventanas. Ninguno de esos conceptos equivale exactamente a una pestaña del emulador de terminal.
Puedes abrir el mismo buffer en dos ventanas con :split y desplazarte por regiones diferentes del archivo. Si modificas su contenido en una vista, ambas reflejan ese mismo buffer. Por contraste, una ventana de tmux contiene panes de terminal que ejecutan procesos distintos; no es una vista interna del editor. La distinción entre ambas capas se desarrolla en el artículo dedicado a tmux, dentro de este bloque.
Una prueba elemental para reconocer el modelo:
:edit src/main.ts
:split
:ls
:buffers
:tabnew
:ls y :buffers muestran el inventario de buffers; no enumeran pestañas del emulador. :split divide la ventana activa y :tabnew crea otra tabpage. Comprender esta distinción evita añadir plugins para resolver un problema de organización que las primitivas del editor ya cubren. La ayuda oficial de ventanas y pestañas documenta estas relaciones.
El editor y el proyecto no tienen el mismo perímetro
Una estación de desarrollo combina por lo menos cuatro responsabilidades:
| Responsabilidad | Quién puede cumplirla | Qué información necesita |
|---|---|---|
| Edición y navegación | Neovim | Buffers, keymaps, estado de ventanas |
| Estructura sintáctica | Parser de Tree-sitter y consultas | Gramática del lenguaje, árbol de sintaxis |
| Semántica del código | Servidor LSP | Proyecto, archivos, dependencias, configuración |
| Ejecución de checks y depuración | CLI, test runner, debug adapter | Binarios, variables, argumentos, proceso destino |
El hecho de que todas aparezcan en una sola interfaz no significa que provengan de un único motor. Una consulta Tree-sitter puede reconocer un bloque de función sin saber si un símbolo exportado existe. Un servidor LSP puede resolver referencias entre archivos sin suministrar el mismo esquema de colores del editor. Un formatter puede modificar espacios, pero no sustituye las comprobaciones de un linter ni la ejecución de pruebas.
Es preferible diagnosticar el componente averiado antes de modificar todo el stack. Si la sintaxis se resalta pero no hay definiciones, comprueba el servidor LSP. Si el servidor funciona pero una acción de completar no aparece, revisa el método de completion y el keymap. Si falla un test, ejecútalo primero desde la CLI con el mismo directorio de trabajo, runtime y variables esperadas.
LSP: el cliente está integrado; el servidor no
El Language Server Protocol define mensajes JSON-RPC entre una herramienta cliente y un servidor que entiende un lenguaje. Neovim incluye un cliente LSP. Para obtener diagnósticos y navegación necesitas además un servidor instalado, como clangd o pyright, y una configuración que indique cuándo iniciarlo.
En Neovim moderno, la forma directa de declarar y activar una configuración es vim.lsp.config() junto a vim.lsp.enable(). El patrón histórico require('lspconfig').clangd.setup({...}) está deprecado en la integración moderna de nvim-lspconfig; muchos tutoriales antiguos aún lo utilizan. La documentación actual de Neovim y la migración de nvim-lspconfig deben prevalecer al copiar ejemplos.
-- ~/.config/nvim/init.lua — fragmento para Neovim >= 0.11
-- Requiere tener el ejecutable clangd disponible en PATH.
vim.lsp.config('clangd', {
cmd = { 'clangd', '--background-index' },
filetypes = { 'c', 'cpp', 'objc', 'objcpp' },
root_markers = { 'compile_commands.json', 'compile_flags.txt', '.git' },
})
vim.lsp.enable('clangd')
vim.keymap.set('n', '<leader>lf', function()
vim.lsp.buf.format({ async = true })
end, { desc = 'Formato LSP del buffer' })
El bloque es un ejemplo ilustrativo no ejecutado; no instala clangd, no crea compile_commands.json y no configura completion adicional. root_markers ayuda a ubicar el directorio del workspace, pero un marcador incorrecto puede producir un proyecto raíz inadecuado. En C y C++, clangd suele necesitar información de compilación confiable; habilitar el cliente sin esa información no resuelve automáticamente includes o flags específicos del proyecto.
Antes de introducir un plugin nuevo, abre un archivo pertinente y comprueba:
:checkhealth vim.lsp
:lua print(vim.inspect(vim.lsp.get_clients({ bufnr = 0 })))
La primera orden muestra verificaciones de la integración; la segunda enumera clientes adjuntos al buffer actual. Si la lista está vacía, revisa la ubicación del ejecutable, el filetype, la raíz del workspace y el diagnóstico del servidor. Si hay cliente pero una acción concreta no funciona, verifica que ese servidor anuncie la capacidad correspondiente.
Completion no es LSP
LSP ofrece métodos para solicitar sugerencias de completado; la experiencia de menú, ranking, snippets y aceptación de candidatos puede venir del cliente nativo o de plugins como blink.cmp. En Neovim 0.12 existe funcionalidad nativa y el propio LSP puede participar en ella, pero un servidor que responde a textDocument/completion no decide por sí solo cómo se dibuja el menú. Del mismo modo, vim.lsp.buf.format() solo puede usar el formato de un cliente que lo soporte: no convierte a ruff, prettier o stylua en formatters integrados si no están conectados mediante una integración apropiada.
La regla de ingeniería es establecer una sola ruta de escritura por tipo de acción cuando varios servidores ofrecen formatting, y una política explícita de prioridad cuando confluyen diagnósticos o proveedores de completado. De otro modo aparecen cambios de formato dobles, errores duplicados y keymaps que ejecutan rutas inesperadas.
Tree-sitter observa estructura, no tipos
Tree-sitter construye un árbol sintáctico incremental y permite consultas para resaltado, selección y plegado. Es valioso para visualizar regiones de código con latencia baja en muchos escenarios, pero no sustituye al análisis semántico del servidor de lenguaje. Por ejemplo, un árbol puede identificar la llamada send(invoice) aunque no sepa qué sobrecarga concreta se invoca.
Tampoco conviene afirmar que el editor instala automáticamente todos los parsers al abrir un archivo. La disponibilidad de un parser y sus consultas depende de la distribución y plugins utilizados. La documentación de Tree-sitter en Neovim y el proyecto nvim-treesitter son fuentes diferentes: el primero documenta la API integrada; el segundo distribuye configuraciones y parsers con su propio ciclo de cambios.
DAP y pruebas: dos flujos que deben permanecer explícitos
El Debug Adapter Protocol estandariza la comunicación entre una interfaz de depuración y un adaptador. nvim-dap implementa el papel de cliente, pero no instala automáticamente el adaptador apropiado para Node.js, Python, C/C++ u otro runtime. Para depurar hacen falta, como mínimo, el adapter correcto, una configuración de lanzamiento o conexión, una ruta de programa válida y un proceso que pueda ser depurado.
Esto es distinto de tests. El runner CLI ejecuta una suite; un panel de editor puede iniciar el runner, mostrar resultados y ubicar tests, pero no cambia la semántica de pytest, cargo test o go test. neotest ofrece integración visual mediante adaptadores específicos; la instalación de un núcleo de neotest no implica soporte automático para cualquier framework.
Para una falla reproducible, el orden práctico es: ejecutar primero el comando del proyecto fuera de Neovim, inspeccionar su código de salida, repetirlo desde la terminal integrada y, recién entonces, revisar la integración del editor. En el artículo dedicado a tmux, que acompaña este bloque, se desarrolla cómo conservar shells, logs y procesos en otros panes sin adjudicar esa persistencia a Neovim.
Gestión de plugins: vim.pack no invalida lazy.nvim
Neovim 0.12 incorpora vim.pack, una alternativa nativa para gestión de paquetes. El proyecto lazy.nvim sigue aportando funcionalidades propias: carga diferida, resolución de dependencias, lockfile, restauración, actualización y profiling. LazyVim es una distribución/opinión de configuración construida sobre plugins; no debe confundirse ni con el gestor lazy.nvim ni con el editor base.
Hay tres estrategias razonables, dependiendo del mantenimiento que se quiera asumir:
- Nativo mínimo: Neovim + un servidor de lenguaje configurado explícitamente y pocos plugins. Menos abstracciones, más decisiones manuales.
- Composición con gestor: Neovim +
lazy.nvimy especificaciones de plugins bajo control de versiones. Más automatización, pero mayor superficie de actualización. - Distribución como LazyVim: convenciones, perfiles y un conjunto amplio de integraciones. Reduce tiempo de ensamblaje, a cambio de comprender los defaults antes de sobrescribirlos.
Ninguna opción es universalmente superior. Una configuración pequeña puede ser suficiente para un repositorio de un lenguaje; un entorno poliglota se beneficia de un gestor y una política de actualizaciones. Antes de copiar una configuración de Internet, registra la versión del editor, el conjunto de plugins, el lockfile si existe y los ejecutables externos requeridos. Un lockfile de plugins no fija automáticamente clangd, git, el intérprete ni los binarios descargados por otros gestores.
Medir la experiencia sin fabricar un benchmark
La percepción de rapidez combina inicio de Neovim, carga de plugins, inicialización de servidores, indexación, acceso a disco y latencia de una terminal remota. Medir solo nvim --startuptime sirve para estudiar una parte del arranque; no demuestra que la navegación LSP o la depuración sean más rápidas que en otro editor.
Un protocolo de comparación razonable registra versión, CPU/OS, tamaño del proyecto, estado frío/caliente de cachés, plugins habilitados y archivos abiertos. Ejecuta varias corridas, conserva resultados sin promediar arbitrariamente las que fallan y distingue startup, tiempo hasta primera interacción y tiempo hasta diagnóstico o referencia semántica. La ayuda sobre startup explica los instrumentos disponibles. No se ejecutó un benchmark para este artículo.
Un criterio para decidir
Neovim es una opción fuerte cuando interesa un modelo de edición por comandos, composición con herramientas Unix, configuraciones versionables y control sobre qué procesos se integran. Su coste es asumir el trabajo de integración: servidores LSP, compatibilidad de parsers, keymaps, diagnósticos, adaptadores y actualización de plugins.
La decisión no es «Neovim contra un IDE» en abstracto. Es qué parte del stack necesitas controlar y qué costes operativos aceptas. Un buen entorno profesional no es el que tiene más plugins: es el que permite explicar por qué una operación funciona, reproducirla en otra máquina y diagnosticar cuál de sus componentes falló.
Para continuar la serie, el artículo dedicado a tmux explica la persistencia de procesos; el de ecosistema moderno del terminal aborda PTYs, emuladores, Zsh, fzf, Atuin y Yazi. Los enlaces cruzados se incorporarán cuando las entradas estén publicadas.
Fuentes técnicas principales
- Neovim 0.12.6 — release oficial.
- Neovim: modelo de ventanas, cliente LSP y Tree-sitter.
- Language Server Protocol 3.17 y Debug Adapter Protocol.
nvim-lspconfig,nvim-dapyneotest.lazy.nvimy LazyVim.