Neovim

Neovim

Notas sobre neovim, instalación, uso, cheatsheet, plugins, etc.

Conceptos básicos

Comandos básicos, modos, etc.

Abrir neovim

nvim                    # Forma normal.
nvim <file>             # Abrir archivo especifico.
nvim <file1 file2 ...>  # Abrir múltiples archivos (en buffers separados).
content_copy

Multiplexores: Abrir múltiples ventanas de neovim en una sola terminal.

nvim -o[num]       # Abre num ventanas de forma horizontal.
nvim -O[num]       # Abre num ventanas de forma vertical.
# No se pueden combinar estos parámetros.

nvim -o[num] <file1 file2 ...fileN> # Abrirá “num” ventanas y en las N primeras pondrá los archivos del uno al N. 
content_copy

Argumentos: Puedes revisar estos argumentos en la página del manual con el comando man nvim.

nvim [options] [file ...]
nvim [options] -
nvim [options] -t tag
nvim [options] -q [errorfile]
content_copy

Los argumentos (no sé si todos) se pueden pasar como comandos y no solo en la terminal. Hablando de los comandos, no es necesario escribir los comandos en su totalidad, a medida que vayas escribiendo, puedes presionar Tab para listar comandos que coincidan con lo que estás escribiendo o si el comando ya se distingue de otros y no has terminado de escribirlo puedes ejecutarlo sin culminar, mientras sea distinguible, neovim deducirá el comando que quieres ejecutar.

:version       # La version de neovim
content_copy

Autocompletado:

Cuando escribes un comando, puedes presionar Tab para autocompletar y/o ver sugerencias de comandos. Imagina que tienes tres archivos de nombre text1.txt, text2.txt y text3.txt y quieres abrir uno de estos.

:edit t<Tab>
content_copy

Al presionar Tab se abrirá una ventana emergente que mostrará todas las sugerencias que empiecen con “t”, que serían los tres archivos y al presionar enter expande el resultado que seleccionamos.

:edit text1.txt
content_copy

Comodines

Como en bash, puedes poner comodines para que te muestre todas las coincidencias que buscas.

:edit *.txt<Tab>
content_copy

En este caso nos mostrará todos los archivos con extensión “.txt” que existan en nuestro directorio para poder seleccionarlos.

Modos

Aquí está el corazón de vim/neovim, los modos son distintas formas en la que el editor entenderá tus acciones de una manera u otra, dependiendo del modo en el que estés y la acción que quieras realizar.

• Normal: Puedes ejecutar combinaciones de teclas, moverte y ejecutar comandos.
• Inserción: Editar el texto.
• Visual: Puedes seleccionar con el cursor.
• Select: Similar al modo visual.
• Replace: Reemplazar caracteres.

Salir de vim

Para salir de vim en el modo normal, primero asegúrate que estás en este modo presionando la tecla Esc una o dos veces y ejecuta cualquiera de los siguientes comandos.

:q       # Salir de manera normal (abreviado).
:quit    # Salir de manera normal (extendido).
:q!      # Salir sin guardar cambios (forzado).
content_copy

Guardar

Ahora que ya trabajamos en nuestros archivos, lo que queremos hacer es guardarlos, esto también se hace desde el modo normal al ejecutar estos comandos.

:w             # Guardado normal.
:w <file.some> # Guardar en archivo específico.
:wq            # Guardar + salir.
:x             # Lo mismo que ":wq".
content_copy

Ayuda Obtener asistencia en vim es simple, la página de ayuda es muy completa y puedes buscar todo lo que necesites en el, o si quieres, puedes revisar la documentación oficial de neovim.

:help                 # Ayuda (extendido).
:h                    # Ayuda (abreviado).
:h <term>             # Paginas de termino especifico.
:h <command>          # Páginas de comando especifico.
:h <mode>_<command>   # Páginas de comando en modo específico.
content_copy

Suspender neovim

Suspender neovim es ponerlo en segundo plano para volver a editar en él después (mientras la terminal siga abierta, caso contrario, todos los procesos de fondo se eliminarán). Los tres comandos hacen lo mismo

:stop
:suspend
Ctrl + z
content_copy

Devolverlo a primer plano:

fg [%id]       # El id puede no ser necesario (en caso quieras abrir el último archivo en segundo plano).
content_copy

Ventanas

Las ventanas o pestañas de vim/neovim trabajan con tres abstracciones de visualización:

• Buffers: Un “buffer” es un área de almacenamiento en la memoria donde se guarda el contenido de un archivo que estás editando (solo el contenido, no tiene nada que ver con la ventana ni la pestaña). Cuando abres un archivo en Vim, su contenido se carga en un buffer para que puedas ver y editar el texto.

• Ventanas: Una “ventana” se refiere a una región en la pantalla donde se muestra el contenido de un buffer. Puedes tener múltiples ventanas abiertas en Vim, cada una mostrando diferentes partes del mismo archivo o mostrando contenido de distintos buffers.

• Pestañas: Las “pestañas” son contenedores que pueden alojar conjuntos de ventanas y buffers. Se utilizan para organizar y trabajar con varios conjuntos de archivos de manera más estructurada.

# Se abren 3 archivos con su respectivo buffer, pero solo se muestra text1.txt. 
nvim text1.txt text2.txt text3.txt

# Comandos para listar buffers
:buffers        # lista todos los buffers existentes.
:files          # lo mismo que buffers.
:ls             # lo mismo que buffers.```
content_copy

#navegar entre buffers
:bnext             # siguiente buffer.
:bprev[ious]       # buffer anterior.
:buffer [num]      # Buffer con numero especifico (listado).
:buffer file.some  # Buffer de archivo específico.

Ctrl + o    # Buffer anterior (no solo los que abres, también los anteriores. Se crearán buffers por cada archivo que abras).
Ctrl + i    # Buffer siguiente. 
content_copy

# Borrar buffers
:bdelete <num>     # Buffer con numero num (ls).
:bdelete <file>    # Buffer con nombre file.
content_copy

:qall        # Cerrar todos los buffers.
:qall!       # Cerrar todos los buffers sin guardar.
:wqall       # Guardar y cerrar todos los buffers.
:xall        # Lo mismo que ":wqall".
content_copy

nvim archivo1.txt
content_copy

:split archivo2.txt  # abrir archivo en pestaña horizontal encima de la actual
:vsplit archivo2.txt # abrir archivo en pestaña verticale a la derecha de la actual
content_copy

Ctrl-W H    # Moves the cursor to the left window
Ctrl-W J    # Moves the cursor to the window below
Ctrl-W K    # Moves the cursor to the window upper
Ctrl-W L    # Moves the cursor to the right window
content_copy

:buffer archivoN.txt
content_copy

Ctrl-W V  # Opens a new vertical split
Ctrl-W S  # Opens a new horizontal split
Ctrl-W C  # Closes a window
Ctrl-W O  # Makes the current window the only one on screen and closes other windows
content_copy

:new    [file]
:split  [file]
:vsplit [file]
content_copy

:tabnew [archivo]   # abre una nueva pestaña.
content_copy

:tabnew file.txt    Open file.txt in a new tab
:tabclose           Close the current tab
:tabnext            Go to next tab
:tabprevious        Go to previous tab
:tablast            Go to last tab
:tabfirst           Go to first tab
content_copy

# en modo normal
gt     # Siguiente pestaña.
gT     # Pestaña anterior.
content_copy

Trabajando con archivos

Puedes abrir neovim sin argumentos y se te abrirá el editor en blanco, y estando ahí puedes abrir archivos con el comando:

:edit <file>
content_copy

Si el archivo existe abre este, caso contrario lo crea.

Podemos trabajar con un explorador de archivos nativo de neovim que se abre con el carácter punto (”.”), el cual parte de nuestro directorio actual.

:edit .
content_copy

Ahora que estamos trabajando con rutas podemos crear archivos, directorios, renombrar, etc (debes estar en el modo edit . para poder hacer esto).

%    Create a new file
d    Create a new directory
R    Rename a file or directory
D    Delete a file or directory
content_copy

Movimiento

Movimiento básico

Para movernos en neovim (en el modo normal) tenemos las siguientes teclas con sus respectivas posiciones a las cuales se desplazarán.

Modificación

Estamos trabajando en un editor de texto, con lo cual queremos modificar el contenido, pero en el modo normal es un poco extraño si es tu primera vez en este editor.

d + [[i|a] dpshjklwtbe...]      # eliminar (i dentro, a con el contenedor)
d + i <caracter>                # eliminar el contenido dentro de ...
d + a <caracter>                # eliminar el contenido más el caracter ...

# caracteres (d + <tecla>)
w                               # Una palabra
p                               # Un párrafo
s                               # Una sentencia
( or )                          # Pares de ( )
{ or }                          # Pares de { }
[ or ]                          # Pares de [ ]
< or >                          # Pares de < >
t                               # etiquetas XML

# Pares de comillas
"        
'        
`        
content_copy

Por ejemplo si tienes:

const hello = function() {
  console.log("Hello Vim");  // di + ( -->  console.log();
  console.log("Hello Vim");  // da + ( -->  console.log;
  return 
	<div>
	  <h1>Header1</h1>       ${/* di + t --> <h1></h1> */}
	  <h1>Header1</h1>       ${/* da + t --> vacío*/}
	  <p>Paragraph1</p>
	  <p>Paragraph2</p>
	</div>
}
content_copy

Para buscar más sobre esto ejecuta el comando :help text-objects.

Búsqueda

Para buscar palabras, párrafos enteros o lo que desees puedes hacerlo desde el modo normal con / o ? y tu termino a buscar, por ejemplo si quieres la palabra “variable” ejecuta el comando /variale o ?variable. Los siguientes operadores en la tabla parten de encontrar coincidencias con las búsquedas anteriores.

\d   # Dígito [0-9]
\D   # No digito [^0-9]
\s   # Caracteres de espaciado (espacio y tab)
\S   # Caracteres de no espaciado (todo excepto espacio y tab)
\w   # Alfanumérico [0-9A-Za-z_]
\l   # Caracteres en minúscula [a-z]
\u   # Caracteres en mayuscula [A-Z]
content_copy

Sustitución

Para reemplazar una palabra o tantas coincidencias como queramos, podemos operar desde el modo normal con las siguientes instrucciones.

Para sustitución básica (desde la línea del cursor en adelante) puedes ejecutar:

:s/pattern/replace/[flag]
content_copy

Las banderas o flags son modificadores que permiten alterar cómo se tratan las expresiones regulares.

&   # Reuse the flags from the previous substitute command.
g   # Replace all matches in the line.
c   # Ask for substitution confirmation.
e   # Prevent error message from displaying when substitution fails.
i   # Perform case insensitive substitution.
I   # Perform case sensitive substitution.
content_copy

Para una sustitución extendida (% significa de archivo completo, pero solo la primer coincidencia de cada línea) ejecutamos:

:%s/pattern/replace/[flag]
content_copy

En el tópico de Búsqueda vemos la combinación de teclas // que es la búsqueda anterior que se hizo y podemos aprovechar eso, por ejemplo buscamos /hola, entonces al ejecutar // estariamos buscando “hola” y podemos reemplazarlo en nuestra sustitución.

:[%]s//replace/[flag]
content_copy

y el comando :s o la tecla & son un shortcut para nuestro último reemplazo, por ejemplo:

:s/hola/mundo   # Sustitución básica
:s              # --> ejecuta :s/hola/mundo
&               # --> lo mismo que :s
content_copy

Sustitución entre rangos:

Podemos sustituir en líneas especificas o entre lineas especificas, del siguiente modo

"El formato [algo] es de un parámetro opcional y el formato <algo> es de un parámetro requerido"

# Formato
:[[inicio],[fin]]s/pattern/replace/[flag]  # formato general.

:<num>s/pattern/replace/[flag]              # Solo reemplaza en la línea num.
:<num>,s/pattern/replace/[flag]             # empezando en la línea num hasta la actual.
:,<num>s/pattern/replace/[flag]             # Desde la línea actual hasta la línea num.
:<i>,<f>s/pattern/replace/[flag]            # Desde la línea i hasta la línea f.

#Ejemplos
:3s/pattern/replace/[flag]          # Reemplaza la línea 3.
:3,s/pattern/replace/[flag]         # Reemplaza desde la línea 3 hasta la actual.
:,80s/pattern/replace/[flag]        # Reemplaza desde la línea actual hasta la línea 80.
:1,6s/pattern/replace/[flag]        # Reemplaza desde la línea 1 hasta la línea 6.
content_copy

Cambiar posición:

Por ejemplo si quieres intercambiar la posición de muchas cosas puedes tener grupos en tus regex e intercalar su orden.

# contenido del archivo
let one = "1";
let two = "2";
let three = "3";

# comando
:%s/\v(\w+) (\w+)/\2 \1

# resultado
one let = "1";
two let = "2";
three let = "3";
content_copy

• Cada (\w+) es un grupo (porque están entre paréntesis en una regexp) y cada grupo está enumerado por un índice que empieza en uno y termina en el número de grupos que exista.

• \1 y \2 son los índices, entonces estamos diciendo que busque el patrón o patrones en la primera expresión (/\v(\w+) (\w+)/) y en la segunda le decimos que ponga el grupo dos al inicio y el grupo uno después o al final (que en este caso es lo mismo).

Solo considerará los grupos existentes, por ejemplo poner \3 no hará nada.

Cambiar delimitador de sustitución:

A veces tendremos la necesidad de cambiar el delimitador ya que es complejo verlo si trabajamos sin magic o con urls, etc. Cambiarlo es tan simple como reemplazarlo con cualquier caracter de un byte unicode que no sean letras del alfabeto, números o ", |y \.

# + es el delimitador
:s+https:\/\/mysite.com\/a\/b\/c\/d\/e+hello+

# sin cambio de delimitador
:s/https:\/\/mysite.com\/a\/b\/c\/d\/e/hello/
content_copy

Esto mejora la legibilidad.

Deshacer

Para deshacer o rehacer tus cambios (en el modo normal) tienes un gran abanico de opciones y comandos a probar, no entiendo muy bien las opciones de la segunda columna porque nos las uso núnca y no les encuentro utilidad en mi flujo de trabajo, así que si quieres apender más sobre esto te invito a leer la documentación oficial.

Insert mode

El modo de inserción de texto permite la edición de texto, pero comúnmente vas a intercalar con el modo normal para ejecutar comandos o desplazarte.

Para ejecutar comandos en este modo puedes ejecutar:

!!<comando>
content_copy

Cuando se procesa y termina la ejecución del comando, el resultado de este se plasmará en el bloque que seleccionaste en este modo.

Comando punto

El comando punto nos permite rehacer cambios rápidamente.

let one = "1";
let two = "2";
let three = "3";
content_copy

Ejecute los siguientes comandos:

/let
cwconst<Enter>
content_copy

Ahora con n posicionate en el siguiente let y presiona la tecla punto ”.”, verás que let se cambió por const. El último cambio ejecutado se guarda en un buffer y el punto lo ejecuta nuevamente donde se posiciona el cursor para acortar este.

Visual mode

El modo visual es similar a seleccionar fragmentos largos manteniendo click en editores de texto con interfaz gráfica.

Para reemplazar en bloque ejecuta (en cualquier modo visual) el siguiente comando sin borrar nada que genere neovim:

:s/string/replace/g
content_copy

Esto sería un ejemplo (los corchetes son la seleccion del modo visual):

[let num1 = 1;
let num2 = 2;]
let num3 = 3;
let num4 = 4;
content_copy

Al ejecutar el comando :s'<,'>/const/let/g el resultado sería:

const num1 = 1;
const num2 = 2;
let num3 = 3;
let num4 = 4;
content_copy

El fragmento '<,'> se refiere al bloque en sí así que no te preocupes por lo que hace, solo debes saber que establece tu bloque seleccionado.

Insertar texto en bloque:

Para agregar texto en un bloque debes estár en el modo visual de bloque Ctrl + v y posicionar tu cursor donde desees, luego de ello presiona las teclas A (insertar despues del cursor de fin) o I (Insertar antes del cursor de inicio).

[const num1 = 1
const num2 = 2
let arr3 = [3,"tres"]
l]et str4 = "cuatro"
content_copy

En este caso empezamos en la “c” de const num1, presionamos Ctrl + v y presionamos 3j lo que seleccionará la primer letra de cada linea, posteriormente presionamos $ lo que hará que se seleccione desde el principio hasta el fin de cada linea y aquí entra en juego las letras A o I.

Si en este punto ejecutamos A y escribimos ; solo se mostrará que se modificó la primer linea, pero para que se apliquen los cambios en toda la linea debemos presionar <Esc>:

const num1 = 1;
const num2 = 2;
let arr3 = [3,"tres"];
let str4 = "cuatro";
content_copy

Y si en caso contrario hubieramos presionado I lo que escribamos se pondrá antes de la primer letra de cada linea, por ejemplo escribamos ”$” y presionemos <Esc>:

$const num1 = 1
$const num2 = 2
$let arr3 = [3,"tres"]
$let str4 = "cuatro"
content_copy

Como explicamos es antes y después de la selección, no del cursor a tener en cuenta.

[!Nota] Si está en el modo visual normal puede ejecutar el comando :normal! [A|I]<string> para insertar texto en bloque del mismo modo que ya vimos. Se ponen al inicio o final de la línea (según hayas escogido A o I) y no importa que hayas seleccionado solo una porción y no toda la línea, la inserción se hará en estos.

Incremento y disminucion:

Los comandos para incrementar y hacer decremento (en el modo visual bloque) son Ctrl + a y Ctrl + x respectivamente.

La utilidad $ de Emmet - item numbering es lo más parecido a estas utilidades, por ejemplo:

<div id="app-1"></div>
<div id="app-[1"></div>
<div id="app-1"></div>
<div id="app-1"></div>
<div id="app-1]"></div>
content_copy

El modo es el visual por bloque y solo tomando los unos, ahora presionaremos g Ctrl + a para incrementar, con cual se verá así:

<div id="app-1"></div>
<div id="app-2"></div>
<div id="app-3"></div>
<div id="app-4"></div>
<div id="app-5"></div>
content_copy

Y si ahora (empezando desde el uno) seleccionas todos los números (en bloque) y presionas Ctrl + x se verá así:

<div id="app-0"></div>
<div id="app-1"></div>
<div id="app-2"></div>
<div id="app-3"></div>
<div id="app-4"></div>
content_copy

También trabaja con letras.

Comandos

Podemos ejecutar comandos para insertarlos en nuestro archivo como vimos en el Insert mode, pero existe otra manera de hacer esto (el resultado del comando se insertará en la línea en la que se encuentre tu cursor):

:[line]r !<comando>
content_copy

Esto se hace en el modo normal.

Para ejecutar un comando y que no se inserte en el documento simplemente vete al modo normal y escribe:

:!<comando> [parametros...]
content_copy

Realmente el comando r es para leer el contenido de archivos y lo hace si le pasas el nombre de un archivo:

:[line]r file.txt
content_copy

También acepta una línea, por ejemplo 10r !ls hará que el resultado del comando se ponga bajo la línea 10 y desplazando a el contenido que estaba bajo esa línea ahora bajo el resultado del comando.

Ejecutar comandos de archivo como argumento:

Podemos ejecutar comandos en una vista similar a la de una pseudoterminal con :w que además de ser el comando para guardar podemos pasarle parámetros para que el contenido del archivo sea un STDIN para los comandos que ejecutemos.

:[num[,fin]]w !<comando>
content_copy

Podemos agregarle uno o dos números de línea para que el comando lea solo esa línea o el rango de líneas que se pasaron.

Ejecutando comandos en la terminal integrada de neovim:

Podemos ejecutar comandos básicos con la siguiente sintaxis (no ejecuta muy bien todos los comandos, pero puede hacer algunas cosas simples):

:[num [,fin]]!<comando [parámetros]>
content_copy

No le veo mucha utilidad como reemplazo a una terminal, pero sí para editar textos, por ejemplo en vez de recordar combinaciones de neovim puedes reemplazar o modificar cosas con comandos como AWK, tr, etc.

Repetir el último comando:

Si no queremos volver a escribir ni navegar hasta el último comando podemos ejecutar el comando @: y listo, se ejecutará el último comando.

Historial de comandos:

Podemos acceder al historial de comandos con el comando :his que desplegará una ventana con estos, por ejemplo:

#  cmd history
1  %s/h,j,k,l/h,n,t,s
2  %s/kitty/alacritty
3  %s/offset-y = 5/offset-y = ${size.offset-y}
4  %s/\\u0020/\\u0020\\u0020
5  %s/${c/$(c/g
6  %s/red-color/blue-color/g
7  %s/button-color/green-color/g
content_copy

Esto solo es una lista, ahora ¿Cómo podemos ejecutar un comando de estos?, pues con el comando q: en el modo normal se abrirá una ventana con el historial de comandos y tenemos dos opciones, ejecutar el comando o modificarlo con el modo inserción.

Doblar

Con “doblar” me refiero a colapsar texto, como el de un editor que quiere ocultar bloques de código que no quiere ver pero sin eliminarlos, ¿cómo podemos colapsar texto?, pues con la tecla z.

zf    # colapsar selección o puedes moverte con teclas de desplazamiento y sus números.
zo    # abrir colapso.
zc    # cerrar colapso.
za    # hacer un toggle entre abrir y cerrar el colapso.
zd    # borrar colapso.
zj    # siguiente colapso.
zk    # colapso anterior.
zR    # Abre todos los pliegues del archivo.
zM    # Cierra todos los pliegues del archivo.
zE    # Borra todos los pliegues del archivo.
content_copy

Tips

Para indentar podemos hacer dos cosas, la primera es el indentado simple, que todo lo seleccionado vaya un espacio de tabulación antes o después del que queramos, que se hace con:

>>
<num>>
<<
<<num>
content_copy

La notación de <num> hace referencia a un número, entonces si presionamos 2 + > entonces hará dos tabulaciones o indentará con doble sangría. Lo mismo con < para reducir la sangría.

Y el indentado “inteligente”, simplemente si estamos sobre una línea presionamos = + = o si estamos sobre un bloque de manera visual o visual de bloque simplemente con = se indica respetando la jerarquía de donde se encuentra todo.