LazyVim a fondo: instalación y estructura

LazyVim no es una caja negra: es la misma estructura que montaste a mano, con una base de plugins ya afinada encima. Pero Neovim 0.12 movió la línea de flotación — parte de lo que justificaba usar una distro ahora viene de fábrica. Antes de instalarla, conviene saber qué te sigue aportando y qué ya no.

Qué aporta LazyVim en Neovim 0.12

Durante años, la propuesta de una distro se resumía en “te doy gestor de plugins, completado y LSP ya cableados”. Neovim 0.12 (estable actual: 0.12.4) trae las tres cosas de serie, así que ese argumento se ha quedado a medias. Vale la pena separar el grano de la paja:

Instalación segura

# 1) Copia de seguridad de tu config y datos actuales
mv ~/.config/nvim ~/.config/nvim.bak
mv ~/.local/share/nvim ~/.local/share/nvim.bak
mv ~/.local/state/nvim ~/.local/state/nvim.bak

# 2) Clona el starter oficial de LazyVim
git clone https://github.com/LazyVim/starter ~/.config/nvim

# 3) Quita el historial git del starter (para hacerlo tuyo)
rm -rf ~/.config/nvim/.git

# 4) Arranca: instalará todo solo
nvim

El primer arranque descarga e instala decenas de plugins. Cuando termine, reinicia Neovim y tendrás un IDE completo funcionando.

La estructura (te sonará)

~/.config/nvim/
├── init.lua                  # una línea: require("config.lazy")
├── lua/
│   ├── config/
│   │   ├── lazy.lua          # arranca LazyVim + tus imports de Extras
│   │   ├── options.lua       # TUS opciones (se fusionan con las de LazyVim)
│   │   ├── keymaps.lua       # TUS keymaps
│   │   └── autocmds.lua      # TUS autocmds
│   └── plugins/              # TUS specs: añadir, override o desactivar
└── lazy-lock.json            # versiones exactas (versiónalo en Git)

Cómo carga LazyVim

En lua/config/lazy.lua, LazyVim se importa como un plugin más y luego importa tus plugins y los Extras que actives:

require("lazy").setup({
  spec = {
    -- 1) la base de LazyVim
    { "LazyVim/LazyVim", import = "lazyvim.plugins" },

    -- 2) los Extras que actives (los añade :LazyExtras)
    { import = "lazyvim.plugins.extras.lang.typescript" },
    { import = "lazyvim.plugins.extras.lang.rust" },

    -- 3) TUS plugins (todo lo que pongas en lua/plugins/)
    { import = "plugins" },
  },
})

El orden importa: LazyVim primero, luego Extras, luego lo tuyo — así lo tuyo siempre gana y puede sobreescribir cualquier default.

El sistema de Extras

Los Extras son módulos oficiales que añaden soporte de un lenguaje o una feature ya configurados y coordinados: servidor LSP, formateador, adaptador de depuración y parser de Treesitter, todo junto y probado. Se gestionan con una UI:

:LazyExtras

Se abre una lista navegable. Pulsa x sobre un extra para activarlo o desactivarlo; LazyVim edita tu lua/config/lazy.lua por ti añadiendo el import. Categorías típicas:

Lo primero que haces después de instalar

Antes de escribir una sola línea de personalización, audita el teclado. LazyVim mapea mucho, y sus decisiones no tienen por qué coincidir con las tuyas:

:map s
:map <C-Space>
:map <Tab>
:checkhealth

En una LazyVim recién instalada verás que s y S pertenecen a flash.nvim, y que <C-Space> también. Eso último es un problema directo en este track: <C-Space> está reservado para el autocompletado. Lo arreglamos en la lección siguiente, que es justo la de doblar la distro sin romperla.