wandres.dev
ARQUITECTO · Distribuciones y LazyVim

¿Distribución o config desde cero?

kickstart, LazyVim, NvChad, AstroNvim: qué son las distribuciones de Neovim, cuándo conviene una y cuándo construir tu propia config. La decisión, sin dogmas.

⏱ 10 min

Construiste tu config a mano en los niveles anteriores, y eso te dio algo impagable: entender cada línea. Existe otro camino —las distribuciones— y un maestro sabe cuándo usar cada uno. Pero ojo: Neovim 0.12 movió la balanza, y los argumentos que servían en 2023 ya no valen tal cual.

🎯 Al terminar esta lección sabrás
  • Qué es una distribución de Neovim y qué resuelve.
  • Qué parte de ese trabajo se lo ha comido el propio editor en 0.12.
  • El panorama: kickstart, LazyVim, NvChad, AstroNvim.
  • Decidir tu camino con criterio propio, sin comprar la respuesta de nadie.

Qué es una distribución

Una distribución es una configuración completa y mantenida por la comunidad, lista para usar: LSP, completado, Treesitter, Git, formateo, keymaps… todo pre-cableado y funcionando desde el primer arranque. Tú la instalas y, si quieres, la personalizas encima.

ℹ️
Una distro no es otro editor

Sigue siendo Neovim con plugins y Lua — exactamente lo que ya sabes montar. La diferencia es que alguien ya ensambló las piezas por ti y las mantiene. Todo lo que aprendiste (specs de lazy, opts, LSP nativo, vim.pack) sigue aplicando.

Qué cambió con 0.12

Durante años el argumento a favor de las distros fue sólido y sencillo: montar un IDE a mano exigía media docena de plugins delicados y bien coordinados entre sí. Ese coste ha bajado bastante.

Lo que en 2023 era un plugin En 0.12
Gestor de plugins (packer, lazy) vim.pack, integrado y con lockfile
Configurar servidores LSP (nvim-lspconfig) vim.lsp.config() y vim.lsp.enable(), o una carpeta lsp/ en el runtimepath
Completado (nvim-cmp y sus fuentes) vim.o.autocomplete con vim.opt.completeopt
Resaltado y plegado (nvim-treesitter.configs) vim.treesitter.start() y el foldexpr nativo
Comentarios (Comment.nvim) gc nativo desde 0.10

Traducido: hoy puedes tener un entorno de trabajo decente con muy pocos plugins, y el init.lua que lo sostiene cabe en una tarde. Eso debilita el argumento de “una distro te ahorra el infierno del cableado”, porque buena parte de ese cableado ya no existe.

⚠️
Lo que 0.12 NO te regala

Sé honesto con la otra mitad de la cuenta. El editor no instala por ti los binarios de los servidores (los pones tú o los pone Mason), no trae buscador difuso de archivos, ni indicadores de Git en el margen, ni formateo al guardar, ni depurador, ni un statusline decente, ni —sobre todo— un vocabulario de atajos ya diseñado y coherente. Eso último es la mitad del valor de una distro y casi nunca se menciona.

El panorama en 2026

🌱

kickstart.nvim

No es una distro: es una config mínima de un archivo, comentada para aprender. Punto de partida para construir la tuya, no destino.

💤

LazyVim

La más popular, de folke (autor de lazy.nvim). Modular, con un sistema de Extras y documentación excelente. La que usamos en este nivel.

NvChad

Muy rápida y cuidada estéticamente, con un framework de UI propio. Si te importa el aspecto y el arranque, mírala.

🚀

AstroNvim

Completa y muy configurable, con su propio ecosistema de plugins de comunidad.

💡
Comprueba la fecha antes de copiar

El cambio de 0.12 dejó obsoleta una cantidad enorme de material: configuraciones de Treesitter con la API de la rama muerta, montajes de LSP a través de capas que ya no hacen falta, discusiones de gestores que asumen que hay que elegir uno. Antes de copiar una config ajena —de una distro, de un blog o de un dotfiles famoso— mira cuándo se escribió y contra qué versión.

El balance, sin vender nada

No hay una respuesta buena. Hay una respuesta tuya, y depende de qué estés optimizando:

Lo que estás optimizando Lo que suele salir a cuenta
Entender de verdad cómo funciona el editor Config desde cero (Niveles 1–4)
Tener un IDE potente hoy, con poco tiempo Una distro
Que el mantenimiento no sea tuyo Una distro: absorbe los cambios de ruptura por ti
Tener el mínimo de plugins posible Config desde cero: hoy cuesta bastante menos que hace dos años
Que el editor arranque exactamente como tú quieres Config desde cero
Poder pedir ayuda y que alguien entienda tu setup Una distro, por pura estadística
Aprender leyendo el código de otros kickstart primero, distro después

Los dos caminos tienen un fallo típico, y conviene nombrarlos los dos. El de la distro es usarla sin entenderla: cuando algo se rompe, no sabes ni en qué archivo mirar. El de la config a mano es el mantenimiento infinito: pasar más tiempo afinando el editor que escribiendo código, y llegar a una configuración de cuarenta plugins que nadie mantiene salvo tú.

Por qué LazyVim en este nivel

Por dos razones prácticas, no por devoción. La primera: está construida sobre lazy.nvim, que ya conoces de la lección 1.2, y su estructura es la misma que montaste tú (lua/config, lua/plugins), así que no tienes que aprender un modelo nuevo. La segunda: su sistema de Extras te da soporte de lenguajes con una línea, que es el mejor ejemplo posible de lo que una distro aporta de verdad.

Aprender a manejarla te enseña a leer y extender configuraciones ajenas, y eso es una habilidad transferible: la usarás cada vez que heredes el setup de otra persona o busques cómo resolvió alguien un problema que tú tienes.

La postura de un maestro

No hay bando bueno, y sospecha de quien te venda uno. Lo que sí hay es una posición de fuerza: tú ya construiste tu config a mano, sabes qué es un servidor LSP, una spec, un opts y un lockfile. Desde ahí puedes usar una distro sin ser su rehén — aprovechas su base mantenida y la doblas a tu voluntad porque entiendes lo que hay debajo. Y desde ahí también puedes hacer lo contrario: mirar la lista de plugins de cualquier distro y tachar los que el editor ya cubre de fábrica. Esa doble lectura, no la elección, es el nivel Arquitecto.

⚔️ Decide con criterio
  1. Escribe la lista de plugins de los que dependes hoy y marca los que 0.12 ya cubre de fábrica. Suele sorprender.
  2. Responde para ti: ¿qué estás optimizando ahora mismo — comprensión, tiempo o mantenimiento?
  3. Si eliges distro, comprométete a una regla: no instalar nada cuyo archivo no sepas localizar.

En las siguientes lecciones montaremos LazyVim y la personalizaremos hasta que sea tan tuya como tu config a mano.