Patrones y filtros: acotar exactamente dónde reacciona

Un autocomando mal acotado no falla: hace su trabajo demasiadas veces, en buffers donde no debía, y su coste aparece disperso por toda la sesión como una lentitud que nadie sabe atribuir. Acotar es la mitad de la ingeniería de este nivel. Neovim ofrece cuatro instrumentos de filtrado —patrón, buffer, cardinalidad y reentrada— y cada uno responde a una pregunta distinta que conviene no confundir.

Patrón: el arte de casar rutas

El patrón se compara siempre contra args.match, nunca contra el nombre visible del archivo, y su sintaxis no es una expresión regular: es el emparejamiento de nombres de archivo de Vim, donde el asterisco cubre cualquier cadena incluidas las barras y la interrogación cubre un solo carácter.

La regla que casi nadie conoce es esta: si el patrón contiene una barra, se compara contra la ruta completa del archivo; si no la contiene, se compara solo contra el nombre final. Esa asimetría explica de golpe la mitad de los autocomandos que “no funcionan”.

local grupo = vim.api.nvim_create_augroup("dios_patrones", { clear = true })

-- Sin barra: casa contra el nombre final, en cualquier directorio
vim.api.nvim_create_autocmd("BufWritePre", {
  group = grupo,
  pattern = "*.lua",
  callback = function(args) vim.print("cualquier Lua: " .. args.file) end,
})

-- Con barra: casa contra la ruta completa expandida
vim.api.nvim_create_autocmd("BufWritePre", {
  group = grupo,
  pattern = "*/nvim/lua/*.lua",
  callback = function(args) vim.print("solo mi config: " .. args.file) end,
})

-- Lista de patrones: la union de todos ellos
vim.api.nvim_create_autocmd("BufWritePre", {
  group = grupo,
  pattern = { "*.ts", "*.tsx", "*.js", "*.jsx" },
  callback = function(args) vim.lsp.buf.format({ bufnr = args.buf }) end,
})

El valor por defecto del patrón es el asterisco solo, es decir, todo. Dejarlo implícito en eventos frecuentes como BufEnter o CursorHold es la causa más habitual de degradación de rendimiento en configuraciones grandes: el callback se invoca para cada buffer de la sesión, incluidos los auxiliares, los del explorador de archivos y los del terminal.

En los eventos que no son de archivo el patrón cambia de dominio por completo. En FileType casa contra el nombre del tipo, de modo que pattern = "lua" es correcto y pattern = "*.lua" jamás casará con nada. En User casa contra el nombre del evento propio. En TermOpen o CmdlineEnter casa contra otros valores documentados en la ayuda de cada evento. Confundir dominios produce autocomandos silenciosamente muertos, que es el peor tipo de fallo: no hay error, simplemente no ocurre nada.

El buffer como ámbito

Existe un filtro más fuerte que cualquier patrón: la clave buffer, que ata el autocomando a un buffer concreto por su número. Un autocomando de buffer muere con el buffer, sin que tengas que limpiarlo, y no se evalúa jamás para ningún otro.

pattern y buffer son mutuamente excluyentes. No son dos filtros que se combinen: son dos formas alternativas de expresar el ámbito, y pasar ambos es un error.

-- Patron de dos fases: FileType decide, el autocomando de buffer actua
vim.api.nvim_create_autocmd("FileType", {
  group = vim.api.nvim_create_augroup("dios_markdown", { clear = true }),
  pattern = { "markdown", "text", "gitcommit" },
  callback = function(args)
    vim.bo[args.buf].textwidth = 80
    vim.wo.spell = true

    -- A partir de aqui, solo para ESTE buffer
    vim.api.nvim_create_autocmd("InsertLeave", {
      buffer = args.buf,
      desc = "Guarda la prosa al salir de insercion",
      callback = function(ev)
        if vim.bo[ev.buf].modified and vim.api.nvim_buf_get_name(ev.buf) ~= "" then
          vim.cmd.write({ mods = { silent = true } })
        end
      end,
    })
  end,
})

Este es el patrón arquitectónico más importante del nivel: usar un evento de clasificación para instalar reacciones acotadas. En vez de registrar un autocomando global sobre InsertLeave que comprueba en cada disparo si el buffer es de prosa, registras uno por buffer justo cuando sabes que lo es. El coste se paga una vez en la detección en lugar de en cada pulsación, y la lógica queda expresada donde corresponde. LspAttach funciona con la misma forma: el evento clasifica, y dentro instalas atajos y comportamientos ligados a args.buf.

once y nested: cardinalidad y reentrada

Los dos últimos filtros no restringen dónde sino cuántas veces y bajo qué reglas de reentrada.

nested merece una explicación cuidadosa porque su comportamiento por defecto es contraintuitivo. Mientras se ejecuta un callback, Neovim suprime la emisión de nuevos autocomandos provocados por las acciones de ese callback. Es una protección deliberada contra la recursión: sin ella, un autocomando de BufWritePre que escriba el buffer se llamaría a sí mismo indefinidamente.

flowchart TD
E[Evento original] --> C[Se ejecuta tu callback]
C --> A[El callback abre un buffer nuevo]
A --> N1[Sin nested: BufEnter no se emite]
A --> N2[Con nested: BufEnter si se emite]
N2 --> O[Se ejecutan los autocomandos de BufEnter]
O --> L[Limite de profundidad si la cadena se realimenta]
style N1 fill:#89b4fa,color:#11111b
style N2 fill:#f9e2af,color:#11111b
style L fill:#f38ba8,color:#11111b

La consecuencia práctica es que un autocomando que abre un archivo, cambia de buffer o modifica el tipo no provocará las reacciones que esperarías, salvo que declares nested = true. Y en cuanto lo declares, asumes la responsabilidad de que la cadena termine.

-- Recargar la vista del explorador tras escribir, sin cadenas infinitas
vim.api.nvim_create_autocmd("BufWritePost", {
  group = vim.api.nvim_create_augroup("dios_recarga", { clear = true }),
  nested = true,
  desc = "Permite que la recarga dispare deteccion de tipo",
  callback = function(args)
    if vim.bo[args.buf].filetype == "" then
      vim.cmd("filetype detect")
    end
  end,
})