21 KiB
Capítulo 3: Abrir y buscar archivos
El objetivo de este capítulo es adentrarte en el modo de abrir y buscar archivos en Vim. Ser capaz de buscar rápidamente es una gran manera de aumentar tu productividad en Vim. Una de las razones por las que tardé en empezar a usar Vim era que no sabía cómo encontrar cosas rápidamente, como se hace en los editores de texto más populares.
Este capítulo está dividido en dos partes. En la primera parte, te enseñaré cómo abrir y buscar archivos sin necesidad de complementos extras. En la segunda parte, te enseñaré cómo abrir y buscar archivos con el complemento FZF.vim. Siéntete libre para saltar a la sección que necesites aprender. Sin embargo, te recomiendo encarecidamente que des un repaso a todo el capítulo ya que siempre se aprende algo (o se recuerda algo olvidado). Dicho esto, ¡empecemos!
Abrir y editar archivos con :edit
:edit
es la manera más simple de abrir un archivo en Vim.
:edit archivo.txt
- Si
archivo.txt
existe, abrearchivo.txt
en un buffer. - Si
archivo.txt
no existe, crea un nuevo buffer paraarchive.txt
.
El autocompletado del nombre (tab
) funciona con :edit
. Por ejemplo, si tu archivo está dentro de una carpeta controller de un proyecto en Rails como por ejemplo ./app/controllers/users_controllers.rb
, puedes utilizar la tecla tab
para ir expandiendo los términos rápidamente:
:edit a<tab>c<tab>u<tab>
:edit
acepta comodines como argumentos. *
reemplaza a cualquier archivo en la carpeta actual. Si solo estás buscando archivo con la extensión .yml
en la carpeta actual, puedes ejecutar:
:edit *.yml<tab>
Después de presionar la tecla tabulador, Vim te mostrará una lista de todos los archivos .yml
que existen en la carpeta actual para poder escoger el que queramos.
Puedes utilizar **
para buscar de manera recursiva. Si quieres buscar todos los archivos *.md
en tu proyecto, pero no estás seguro de en qué carpeta está, puedes ejecutar lo siguiente:
:edit **/*.md<tab>
:edit
puede ser utilizado para ejecutar netrw
, el explorador nativo de Vim (del que trataremos más adelante en este capítulo). Para hacer eso, se debe dar al comando :edit
un argumento como directorio en vez de un archivo. Por ejemplo:
:edit .
:edit test/unit/
:edit
también acepta un comando externo (Ex) como argumento (trataré más adelante los comandos externos en capítulos posteriores) cuando va seguido por un signo +
. Aquí hay algunos ejemplos:
- Para ir a la línea 5 del archivo (
:5
)::edit +5 /test/unit/helper.spec.js
- Para ir a la primera línea que contenga la cadena de texto
"const"
(/const
)::edit +/const /test/unit/helper.spec.js
- Para eliminar todas las líneas vacías (
:g/^$/d
)::edit +g/^$/d test/unit/helper.spec.js
Buscando archivos con :find
Puedes buscar archivos con el comandos :find
. Por ejemplo:
:find package.json
:find app/controllers/users_controller.rb
El autocompletado del nombre también funciona con el comando :find
:
:find p<tab> Para encontrar el archivo package.json
:find a<tab>c<tab>u<tab> Para encontrar la ruta del archivo app/controllers/users_controller.rb
Quizás has notado que la sintaxis y el comportamiento del comando :find
es similar al comando :edit
. La diferencia es que :find
encuentra un archivo en la ruta o path
, mientras que :edit
no lo hace.
Aprendamos un poco más sobre esta ruta o path
. Una vez que aprendas cómo modificar tus rutas, :find
puede convertirse en una herramienta de búsqueda muy potente. Para comprobar cuales son tus rutas, ejecuta:
:set path?
De manera predeterminada, quizás el resultado de ese comando sea algo parecido a esto:
path=.,/usr/include,,
Esto es lo que significa:
.
significa buscar en relación al directorio del archivo actual,
significa buscar en el directorio actual/usr/include
es un directorio.
La conclusión aquí es que puedes modificar tus propios caminos. Supongamos que esta es la estructura de tu proyecto:
app/
- assets/
- controllers/
- application_controller.rb
- comments_controller.rb
- users_controller.rb
...
Si quieres ir al archivo users_controller.rb
desde el directorio raíz, debes pasar por varios directorios (y pulsar un considerable número de veces la tecla tabulador). A veces solo te interesa el directorio controllers/
, por lo que quieres buscar inmediatamente dentro de ese directorio sin necesidad de pasar antes por app/
y controllers/
cada vez que busque un archivo. path
puede acortar ese viaje entre directorios.
Puedes añadir el directorio controllers/
a path
mediante:
:set path+=app/controllers/
Ahora que tu ruta ha sido actualizada, cuando escribas :find u<tab>
, Vim también buscará coincidencias dentro del directorio app/controllers/
de archivos que empiezen con "u".
Si tienes un directorio controllers/
anidado, como app/controllers/account/users_controller.rb
, Vim no encontrará users_controllers
. En su lugar es necesario añadir :set path+=app/controllers/**
así el autocompletado podrá buscar users_controller.rb
.
Podrás estar pensando en añadir los directorios del proyecto entero así cuando pulses tab
, Vim buscará en cualquier lugar el archivo deseado, de esta manera:
:set path+=$PWD/**
$PWD
hace referencia al directorio de trabajo actual. Si intentas añadir el proyecto entero a path
para que así todos los archivos puedan ser buscado al presionar el tabulador tab
, aunque esto puede funcionar para un proyecto pequeño, hacer esto puede ralentizar tus búsquedas de manera significativa si tienes muchos archivos en tu proyecto. Recomiendo solo añadir a path
los directorios de los archivos más visitados.
Actualizar path
solo te llevará unos segundos y haciendo esto te ahorrarás un montón de tiempo.
Buscando en archivos con :grep
Si necesitas encontrar un archivo, puedes usar grep. Vim tiene dos maneras de hacer esto:
- grep interno (
:vim
. Sí, se escribe:vim
. Es el diminutivo para:vimgrep
). - grep externo (
:grep
).
Revisemos el grep interno primero. :vim
tiene la siguiente sintaxis:
:vim /patrón/ archivo
/patrón/
es el patrón de la expresión regular (regex) del termino buscado.file
es el argumento del nombre(s) de el(los) archivo(s). De la misma forma que:find
, también puedes pasarle los comodines*
y**
.
Por ejemplo, para encontrar todas las coincidencia de la cadena "foo" dentro de cualquier archivo ruby (.rb
) dentro de la carpeta app/controllers/
:
:vim /foo/ app/controllers/**/*.rb
Después de ejecutar este comando, serás redirigido al primer resultado. El comando de búsqueda de Vim vim
usa la operación quickfix
. Para ver todos los resultados de la búsqueda, ejecutamos :copen
. Esto abre una ventana quickfix
. Aquí dejamos algunos comandos de quickfix útiles para empezar a trabajar:
:copen Abrir la ventana quickfix
:cclose Cerrar la ventana quickfix
:cnext Ir al siguiente error
:cprevious Ir al error anterior
:colder Ir a la lista de errores mas antigua
:cnewer Ir a la lista de errores mas nueva
No voy a profundizar mas en quickfix aquí. Para aprender mas sobre quickfix, revisa :h quickfix
.
Es posible que observes que ejecutar el grep interno (:vim
) podría ralentizarse si tienes una gran cantidad de coincidencias. Esto es provocado porque las lee desde la memoria. Vim carga cada archivo con coincidencias como si estuvieran siendo editados.
Ahora hablemos del grep externo. Por defecto, usa el comando grep
de la terminal de comandos. Para buscar el termino "foo" dentro de un archivo de archivo ruby dentro del directorio app/controllers/
, podemos hacer lo siguiente:
:grep "foo" app/controllers/**/*.rb
De la misma forma que :vim
, :grep
acepta *
y **
. También muestra todos las coincidencias usando quickfix
.
Vim usa la variable grepprg
para determinar qué programa externo ejecutar cuando usamos :grep
así no tienes que usar el comando grep
de la terminal. Posteriormente en este articulo, vermos como cambiar el comando externo predeterminado.
Navegando los archivos con netrw
netrw
el explorador de archivos predeterminado de Vim. Es útil para ver la estructura jerárquica de un proyecto. Para poder usar netrw
, necesitas estas 2 configuraciones en tu .vimrc
:
set nocp
filetype plugin on
Solo veremos el uso básico de netrw
, debería ser suficiente para empezar. Puedes iniciar netrw
cuando inicias Vim y darle un directorio como argumento en lugar de un archivo. Por ejemplo:
vim .
vim src/client/
vim app/controllers/
Para iniciar netrw
dentro de Vim, podemos usar :edit
y darle un directorio como argumento directamente en lugar del nombre de un archivo:
:edit .
:edit src/client/
:edit app/controllers/
Existen otras formas de abrir una ventana de netrw
sin darle de argumento un directorio:
:Explore Inicia netrw en el archivo actual
:Sexplore No es broma. Inicia netrw en una pantalla dividida en la mitad superior
:Vexplore Inicia netrw en una pantalla dividida en la mitad izquierda
Podemos navegar netrw
con los movimientos de Vim (veremos más sobre este tema en el capítulo 5). Si necesitas crear, eliminar, y renombrar un archivo/directorio, aquí tienes una lista de comandos netrw
muy útiles:
% Crear un nuevo archivo
d Crear un nuevo directorio
R Renombrar un archivo o directorio
D Eliminar un archivo o directorio
:h netrw
es muy completo. Pruébalo si tienes tiempo.
Si piensas que netrw
es muy simple y necesitas más, vim-vinegar es un buen complemento para mejorar netrw
. Si lo que buscas es un buscador de archivos diferente, NERDTree es una buena alternativa. ¡Pruébalos!
FZF
Ahora que aprendimos a abrir y a buscar archivos en Vim con las herramientas incluidas, es hora de usar complementos para mejorar nuestra búsqueda.
Un acierto de los editores de texto modernos que Vim no posee es la facilidad de encontrar archivos y encontrar en los archivos. En esta segunda mitad del capítulo, te mostraré como usar FZF.vim para volver tus búsquedas en Vim mas fáciles y poderosas.
Configuración
Pero primero, verifiquemos que tenemos FZF y ripgrep descargados. Para esto seguiremos las instrucciones incluidas en los respectivos repositorios de github. Los comandos fzf
y rg
deberían empezar a estar disponibles después de que las instalaciones de ambas herramientas fueran exitosas.
Ripgrep es una herramienta de búsqueda muy parecida a grep (de ahí el nombre). Generalmente es más rápida que grep y posee muchas características interesantes. FZF es un buscador disperso (fuzzy finder) de propósito general para la línea de comandos. Puedes usarlo con cualquier comando incluyendo ripgrep. Juntos, hacen una poderosa herramienta de búsqueda.
FZF no usa ripgrep por defecto, así que necesitamos decirle a FZF que use ripgrep con la variable FZF_DEFAULT_COMMAND
. En mi .zshrc
(.bashrc
si usas bash), deberíamos tener esto:
if type rg &> /dev/null; then
export FZF_DEFAULT_COMMAND='rg --files'
export FZF_DEFAULT_OPTS='-m'
fi
Debemos poner especial atención a -m
en FZF_DEFAULT_OPTS
. Esta opción nos permite hacer selecciones múltiples con tab
o shift-tab
. No es necesario tener esta línea para que FZF funcione con Vim, pero creo que es una opción muy útil que considerar. Puede volverse muy util cuando quieres realizar búsquedas y reemplazar en múltiples archivos, abarcaremos ese tema en un momento. FZF
acepta más opciones, para aprender más, revisa el repositorio de fzf o man fzf
. Bastará con que tengas export FZF_DEFAULT_COMMAND='rg'
.
Después de instalar FZF y ripgrep, vamos a configurar el complemento FZF. Estoy usando vim-plug como manejador de complementos en este ejemplo, pero puedes usar el que prefieras.
Tenemos que agregar lo siguiente en .vimrc
en la sección de complementos. Necesitas usar el complemento FZF.vim (creado por el mismo autor de FZF).
Plug 'junegunn/fzf.vim'
Plug 'junegunn/fzf', { 'do': { -> fzf#install() } }
Para más información sobre este complemento, puedes revisar FZF.vim repo.
La sintaxis de FZF
Para ser capaz de utilizar FZF de manera eficiente, deberías aprender la sintaxis básica de FZF. Afortunadamente, la lista es corta:
^
es una coincidencia exacta de prefijo. Para buscar una frase que comience con "bienvenidos":^bienvenidos
.$
es una coincidencia exacta de sufijo. Para buscar una frase que finalice con "amigos":amigos$
.'
es una coincidencia exacta. Para buscar la frase "bienvenidos mis amigos":'bienvenidos mis amigos
.|
es una coincidencia "o". Para buscar tanto "amigos" como "enemigos":amigos | enemigos
.!
es una coincidencia inversa. Para buscar una frase que contenga "bienvenidos" y no "amigos":bienvenidos !amigos
.
Puedes mezclar y combinar estas opciones. Por ejemplo, ^hola | ^bienvenidos amigos$
buscará la frase que comience tanto con "hola" como "bienvenidos" y que acabe con "amigos".
Encontrar archivos
Para encontrar archivos dentro de Vim utilizando el complemento FZF.vim, puedes utilizar el método :Files
. Ejecuta :Files
desde Vim y se le mostrará el símbolo del sistema de la búsqueda con FZF.
Ya que utilizarás frecuentemente este comando, es una buena idea asignarle un mapeado del teclado. He mapeado el mío con Ctrl-f
. En mi archivo .vimrc
, he añadido lo siguiente:
nnoremap <silent> <C-f> :Files<CR>
Encontrar en archivos
Para buscar dentro de archivos, puedes utilizar el comando :Rg
.
De nuevo, como es probable que utilices esto de manera frecuente, vamos a incluirlo en el mapeado. He creado un atajo de teclado con <Leader>f
.
nnoremap <silent> <Leader>f :Rg<CR>
Otras búsquedas
FZF.vim ofrece muchos otros comandos de búsquedas. No repasaré todos de manera exahustiva, pero puedes revisarlos aquí.
Este es el aspecto del mapeado de mis comandos FZF. ¡Sientete libre de tomarlos prestados para crear tus propios mapeados!
nnoremap <silent> <Leader>b :Buffers<CR>
nnoremap <silent> <C-f> :Files<CR>
nnoremap <silent> <Leader>f :Rg<CR>
nnoremap <silent> <Leader>/ :BLines<CR>
nnoremap <silent> <Leader>' :Marks<CR>
nnoremap <silent> <Leader>g :Commits<CR>
nnoremap <silent> <Leader>H :Helptags<CR>
nnoremap <silent> <Leader>hh :History<CR>
nnoremap <silent> <Leader>h: :History:<CR>
nnoremap <silent> <Leader>h/ :History/<CR>
Reemplazar grep
con rg
Como he mencionado previamente, Vim tiene dos maneras de buscar en archivos: :vim
y :grep
. :grep
utiliza la herramienta externa de búsqueda que puedes reasignar utilizando la palabra clave grepprg
. Te mostraré cómo configurar Vim para utilizar ripgrep en vez del grep de la terminal al ejecutar el comando :grep
.
Ahora configuraremos grepprg
así :grep
utilizará. Añade esto en tu archivo de configuración vimrc
.
set grepprg=rg\ --vimgrep\ --smart-case\ --follow
¡No dudes en modificar cualquiera de las opciones anteriores! Para más información de lo que significan las opciones anteriores, echa un vistazo a man rg
.
Después de Actualizar grepprg
, ahora cuando ejecutes :grep
, esto ahora ejecutará rg --vimgrep --smart-case --follow
en vez de ejecutar grep
. Si quieres realizar una búsqueda de "foo" utilizando ripgrep, ahora puedes ejecutar el comando mencionado :grep "foo"
en vez de :grep "foo" . -R
(además, ripgrep hace búsquedas más rápidas que grep).
Como ocurre con el antiguo :grep
, este nuevo :grep
también utiliza quickfix para mostrar los resultados.
Podrías preguntarte, "Bien, esto está bien, pero nunca he utilizado :grep
en Vim, además ¿no puedo simplemente utilizar :Rg
para encontrar frases en archivos? ¿Cuanto tendré que necesitar utilizar:grep
?
Esta es una buena pregunta. Quizás necesites utilizar :grep
en Vim para buscar y reemplazar en múltiples archivos, que será lo que veremos a continuación.
Buscar y reemplazar en múltiples archivos
Los editores de texto modernos como VSCode hacen muy sencillo el buscar y reemplazar una cadena de texto en múltiples archivos a la vez. En mis primeros días utilizando Vim, cuando tenía que buscr y reemplazar una cadena en múltiples archivos, utilizaba Atom porque no podía hacerlo fácilmente en Vim. En esta sección, te mostraré dos métodos diferentes para hacer eso en Vim.
El primer método es reemplazar todas las frases coincidentes en tu proyecto. Necesitarás utilizar :grep
. Si necesitas reemplazar todos las coincidencias de la palabra "pizza" y sustituirla por "donut", esto es lo que tienes que hacer:
:grep "pizza"
:cfdo %s/pizza/donut/g | update
¿Eso es todo? ¡Sep! Vamos a diseccionar los pasos que hacen estos comandos:
:grep pizza
utiliza ripgrep para realizar una búsqueda de todas las instancias donde aparezca la palabra "pizza" (por cierto, esto también funcionaría incluso si no has reasignadogrepprg
para utilizar ripgrep. Deberías ejecutar:grep "pizza" . -R
en vez de:grep "pizza"
). Prefiero utilizar ripgrep para esta tarea debido a su sintaxis más concisa.:cfdo
ejecuta cualquier comando que le asignes a continuación en la lista de quickfix. En este caso, tu comando es un comando de sustitución%s/pizza/donut/g
. La tubería (|
) es un operador de cadena. Necesitarás ejecutarupdate
para guardar cada archivo después de ser sustituido. Veremos el comando de sustitución en profundidad en un capítulo posterior.
El segundo método es buscar y reemplazar en el archivo seleccionado. Con este método, puedes escoger de manera manual qué archivos seleccionar y realizar la sustitución. Esto es lo que tienes que hacer:
- Limpiar tus buffers. Es imprescindible que tu lista de buffers contenga solo los archivos que necesitas. Puedes realizar esa limpieza mediante
%bd | e# | bd#
(o reiniciar Vim). - Ejecuta
:Files
. - Selecciona todos los archivos que deseas que se busque y se reemplace la cadena de texto. Para seleccionar múltiples archivos, utiliza
tab
/shift+tab
. Esto solo es posible si tienes la opción-m
enFZF_DEFAULT_OPTS
(consulta la sección anterior de ajustes de FZF para saber qué hace la opción-m
). - Ejecuta
:bufdo %s/pizza/donut/g | update
. El comando:bufdo %s/pizza/donut/g | update
tiene un aspecto similar al anterior comando:cfdo %s/pizza/donut/g | update
. Esto es debido a que son similares. La diferencia es que en vez de realizar la sustitución en toda la lista de archivos de quickfix (:cfdo
), estás realizando la sustitución en todos los buffers abiertos en Vim (:bufdo
).
Aprende a buscar de la manera más inteligente
La acción de buscar dentro de la edición de texto es una tarea imprescindible. Aprender cómo buscar de manera correcta en Vim te ayudará a mejorar tu manera de editar texto.
FZF.vim es un elemento diferenciador. No puedo imaginar utilizar Vim sin él. Creo que es muy importante tener una buena herramienta de búsqueda al empezar con Vim. He visto a personas abandonar la transición a Vim debido a que es una de las funcionalidades modernas que tienen los editores de texto modernos y de la que Vim carece. Yo fui una de esas personas. Espero que este capítulo resuelva uno de los problemas y ayude a hacer la transición a Vim más sencilla. Para mejorar tu destreza con las búsquedas aún más, te sugiero echas un vistazo al repositorio de fzf.
También has visto en acción las posibilidades expansión de Vim, la posibilidad de poder extender las funcionalidades de búsqueda con un complemento y/o con programas externos. En el futuro, ten en cuenta qué otras funcionalidades desearías extender en Vim. Las opciones son, alguien ha creado un complemento o ya existe un programa para ello.
Lo próximo, hablemos sobre un tema muy importante en Vim: la gramática.