Introducción

flash.nvim es un plugin de Neovim que optimiza la navegación de código al integrar etiquetas de búsqueda, movimientos de caracteres mejorados y análisis sintáctico con Treesitter. Esta herramienta está diseñada para desarrolladores que buscan rapidez y precisión al desplazarse por archivos de código.

Características principales

Integración de búsqueda inteligente

El plugin extiende las funciones nativas de búsqueda en Neovim para ofrecer etiquetas de salto dinámicas. Al usar los comandos de búsqueda (como / o ?), se muestran etiquetas junto a las coincidencias, permitiendo saltos rápidos sin conflictos con el patrón de búsqueda. Admite caracteres múltiples y asigna etiquetas de forma eficiente.`

Movimientos de caracteres mejorados

Las funciones tradicionales de salto a caracteres (como f, F, t, T) se mejoran con repeticiones inteligentes. Por ejemplo, después de ejecutar un salto con f{char}, se puede usar f para continuar o F para retroceder. Las teclas ; y , facilitan la navegación entre coincidencias, y los resaltados se limpian automáticamente al cambiar de contexto.`

Integración profunda con Treesitter

Al aprovechar el análisis sintáctico de Treesitter, flash.nvim permite navegar por la estructura del código. Esto incluye resaltar nodos jerárquicos, seleccionar rangos de nodos específicos y comprender el contexto para saltos basados en la sintaxis.

Modos de búsqueda flexibles

El plugin soporta tres estrategias de búsqueda: modo exacto para coincidencias literales, modo regex para patrones regulares y modo difuso para búsquedas tolerantes a errores.

Instalación y configuración básica

Requisitos

Se necesita Neovim versión 0.8.0 o superior, compilado con LuaJIT.

Mapeos de teclas recomendados

local keymaps = {
  { "s", mode = { "n", "x", "o" }, function() require("flash").jump() end },
  { "S", mode = { "n", "x", "o" }, function() require("flash").treesitter() end },
  { "r", mode = "o", function() require("flash").remote() end },
  { "R", mode = { "o", "x" }, function() require("flash").treesitter_search() end },
  { "<c-s>", mode = { "c" }, function() require("flash").toggle() end },
}
</c-s>

Es crucial usar funciones Lua o el formato <cmd>lua en los mapeos para preservar la funcionalidad de repetición.

Configuración avanzada

Personalización del sistema de etiquetas

label_options = {
  allow_uppercase = true,
  excluded_chars = "hjkliardc",
  display_style = "overlay",
  rainbow_effect = {
    enabled = false,
    intensity = 5
  }
}

Ajuste de comportamiento de búsqueda

search_settings = {
  multi_window = true,
  wrap_around = true,
  default_mode = "exact",
  excluded_windows = {
    "notify",
    function(win_id) return not vim.api.nvim_win_get_config(win_id).focusable end
  }
}

Control de saltos

jump_params = {
  track_jumps = true,
  target_position = "start",
  auto_jump_on_single = false,
  include_current = nil
}

Aplicaciones prácticas

Navegación estructurada con Treesitter

Usando el modo Treesitter (mapeado a S), se pueden seleccionar bloques de funciones, saltar a nodos sintácticos específicos y visualizar la jerarquía del código.

Operaciones remotas

El modo remoto (mapeado a r) permite iniciar una operación en una posición, saltar a otro lugar, seleccionar un rango y regresar automáticamente. Por ejemplo, para copiar una palabra desde un punto distante.

Flujo de búsqueda eficiente

Al activar la búsqueda con / o ?, se ingresa un patrón, se navega mediante etiquetas y se confirma con <CR> para ir a la primera coincidencia.`

Optimización del rendimiento

Para mejorar la eficiencia, se pueden configurar exclusiones de ventanas, desactivar resaltados innecesarios y ajustar la reutilización de etiquetas según el modo de operación.

Solución de problemas comunes

Si las etiquetas no aparecen, verifique la configuración de longitud mínima del patrón y las ventanas excluidas. Para inexactitudes en saltos, ajuste los parámetros de posición y desactive el salto automático si es necesario. Si el rendimiento disminuya, reduzca la cantidad de ventanas en búsqueda o simplifique la configuración de resaltado.