El árbol de deshacer (undo tree)

En casi todos los editores, deshacer y volver a escribir borra el “futuro” que descartaste. En Neovim no: cada rama se guarda. El historial de deshacer es un árbol completo, y con undofile sobrevive incluso a cerrar el editor.

Deshacer lineal vs árbol

Imagina: escribes A, luego B. Deshaces B y escribes C. En un editor normal, B se ha perdido para siempre. En Neovim, tu historial es:

flowchart TD
Base[estado inicial] --> A[edicion A]
A --> B[edicion B]
A --> C[edicion C]
style Base fill:#45475a,color:#cdd6f4
style B fill:#f9e2af,color:#11111b
style C fill:#a6e3a1,color:#11111b

Tanto B como C siguen ahí. Puedes volver a cualquier rama. Nunca pierdes trabajo por deshacer y re-escribir.

Persistencia entre sesiones

Ya activaste esto en el Nivel 1, pero aquí está su verdadero valor:

vim.o.undofile = true      -- guarda el historial en disco
vim.o.undolevels = 10000   -- muchísimos pasos de deshacer

No hace falta que toques undodir: Neovim ya trae una carpeta propia dentro de su directorio de estado. Compruébala con :echo &undodir y cámbiala solo si quieres otra ruta.

Con undofile, cierras Neovim, vuelves mañana, abres el archivo y puedes deshacer cambios de ayer. El historial persiste.

Viajar en el tiempo

Más allá de u y Ctrl-r:

Visualizar el árbol: undotree

Ver el árbol como texto es abstracto. undotree lo dibuja y te deja navegarlo visualmente:

return {
  "mbbill/undotree",
  cmd = { "UndotreeToggle", "UndotreePersistUndo" },
  keys = {
    { "<leader>u", "<cmd>UndotreeToggle<cr>", desc = "Árbol de deshacer" },
  },
  init = function()
    vim.g.undotree_WindowLayout = 2
    vim.g.undotree_SetFocusWhenToggle = 1
  end,
}

vim.g.undotree_WindowLayout = 2         -- árbol a la izquierda, diff abajo del todo
vim.g.undotree_SetFocusWhenToggle = 1   -- el cursor salta al panel al abrirlo

vim.pack.add({ { src = "https://github.com/mbbill/undotree" } })

vim.keymap.set("n", "<leader>u", "<cmd>UndotreeToggle<cr>", { desc = "Árbol de deshacer" })

Las vim.g.undotree_* se leen cuando el panel se dibuja, así que en lazy van en init (antes de cargar el plugin) y con vim.pack basta con ponerlas arriba del init.lua.

Pulsa <leader>u y aparece un panel con todas las ramas y marcas de tiempo. Navégalas y verás el estado del archivo en cada punto. Recuperar código “perdido” pasa de ser imposible a un par de teclas.