Guía Completa de Vim y Neovim

sudo apt update
sudo apt install vim

sudo dnf install vim-enhanced

brew install vim

sudo add-apt-repository ppa:neovim-ppa/stable
sudo apt update
sudo apt install neovim

sudo dnf install neovim

brew install neovim

sudo pacman -S neovim

curl -LO https://github.com/neovim/neovim/releases/latest/download/nvim.appimage
chmod u+x nvim.appimage
./nvim.appimage

choco install neovim
# O
scoop install neovim

# Vim
vim --version

# Neovim
nvim --version

# En ~/.bashrc o ~/.zshrc
alias vim='nvim'
alias vi='nvim'

:set ignorecase   " Ignorar mayúsculas/minúsculas
:set smartcase    " Case-sensitive si hay mayúsculas
:set incsearch    " Búsqueda incremental
:set hlsearch     " Resaltar búsquedas
:nohlsearch       " Quitar resaltado (o :noh)

/\<vim\>        " Palabra exacta "vim"
/^#             " Líneas que empiezan con #
/error.*$       " "error" hasta fin de línea
/[0-9]\+        " Uno o más dígitos
/\d\{3}-\d\{4}  " XXX-XXXX (teléfono)

ciw    " Change inner word
da"    " Delete a quote (incluye comillas)
yi(    " Yank inner parentheses
vit    " Visual select inner tag
ci{    " Change inner braces

"ayy       " Copiar línea al registro a
"ap        " Pegar desde registro a
"Ayy       " Añadir línea al registro a
"_dd       " Eliminar sin guardar
"+y        " Copiar al clipboard del sistema
"+p        " Pegar desde clipboard

:registers      " Ver todos los registros
:reg a b c      " Ver registros específicos

q{registro}     " Empezar a grabar en registro
... comandos ...
q               " Terminar grabación

@{registro}     " Ejecutar macro
@@              " Repetir último macro
{n}@{registro}  " Ejecutar n veces

# Lista:
item 1
item 2
item 3

# Grabar macro en registro a:
qa              " Empezar grabación
I- <Esc>        " Insertar "- " al inicio
j               " Bajar una línea
q               " Terminar grabación

# Ejecutar:
2@a             " Aplicar a siguientes 2 líneas

# Resultado:
- item 1
- item 2
- item 3

# Ver contenido del registro
:echo @a

# Editar
:let @a = 'nuevo contenido'

# O pegar en buffer, editar, y copiar de vuelta
"ap             " Pegar macro
... editar ...
"ayy            " Copiar de vuelta

Ctrl+^      " Alternar entre buffer actual y anterior
Ctrl+o      " Saltar a posición anterior
Ctrl+i      " Saltar a posición siguiente

:[rango]s/patrón/reemplazo/[flags]

# Reemplazar en todo el archivo
:%s/foo/bar/g

# Reemplazar en líneas 10-20
:10,20s/old/new/g

# Reemplazar con confirmación
:%s/foo/bar/gc

# Reemplazar solo palabras completas
:%s/\<foo\>/bar/g

# Eliminar espacios al final de línea
:%s/\s\+$//g

# Añadir ; al final de líneas con texto
:%s/\(.\+\)/\1;/g

# Reemplazar en selección visual
:'<,'>s/old/new/g

# Case-insensitive
:%s/error/ERROR/gi

# Eliminar líneas vacías
:g/^$/d

# Eliminar líneas que contengan patrón
:g/DEBUG/d

# Mantener solo líneas que coincidan
:v/KEEP/d

# Duplicar líneas que contengan patrón
:g/TODO/t.

# Mover líneas que contengan patrón
:g/ERROR/m$

# Convertir "lastName" a "last_name"
:%s/\([a-z]\)\([A-Z]\)/\1_\L\2/g

# Convertir a mayúsculas primera letra
:%s/\<\(\w\)/\u\1/g

# Invertir orden (swap)
:%s/\(.*\), \(.*\)/\2 \1/g

:set foldmethod=manual    " Manual
:set foldmethod=indent    " Por indentación
:set foldmethod=syntax    " Por sintaxis
:set foldmethod=marker    " Por marcadores
:set foldmethod=expr      " Por expresión

:set foldlevel=0     " Cerrar todos
:set foldlevel=99    " Abrir todos
zm                   " Aumentar foldlevel (cerrar más)
zr                   " Disminuir foldlevel (abrir más)

m{a-z}      " Marca local al buffer
m{A-Z}      " Marca global (entre archivos)

:marks          " Ver todas las marcas
:marks abc      " Ver marcas específicas

:w              " Guardar
:w archivo      " Guardar como
:w!             " Forzar guardar
:wa             " Guardar todos
:q              " Salir
:q!             " Forzar salir
:wq o :x        " Guardar y salir
:qa             " Salir de todos
:qa!            " Forzar salir de todos
:e archivo      " Editar archivo
:e!             " Recargar archivo
:saveas archivo " Guardar como (cambiar nombre)

:!comando       " Ejecutar comando shell
:r !comando     " Insertar output de comando
:w !comando     " Pasar buffer a comando
:%!comando      " Filtrar buffer por comando

:!ls            " Listar archivos
:r !date        " Insertar fecha
:%!sort         " Ordenar líneas
:%!python -m json.tool  " Formatear JSON

:help            " Ayuda general
:help comando    " Ayuda de comando específico
:help 'opción'   " Ayuda de opción
:helpgrep patrón " Buscar en ayuda
Ctrl+]           " Seguir enlace (en ayuda)
Ctrl+t           " Volver (en ayuda)

" ============================================
" CONFIGURACIÓN BÁSICA
" ============================================

" Deshabilitar compatibilidad con vi
set nocompatible

" Habilitar tipo de archivo y plugins
filetype plugin indent on

" Habilitar sintaxis
syntax enable

" Codificación
set encoding=utf-8
set fileencoding=utf-8

" ============================================
" INTERFAZ
" ============================================

" Números de línea
set number          " Mostrar números
set relativenumber  " Números relativos

" Cursor
set cursorline      " Resaltar línea actual
set scrolloff=8     " Mantener 8 líneas visibles arriba/abajo

" Búsqueda
set incsearch       " Búsqueda incremental
set hlsearch        " Resaltar búsquedas
set ignorecase      " Ignorar mayúsculas en búsqueda
set smartcase       " Case-sensitive si hay mayúsculas

" Interfaz
set showcmd         " Mostrar comando en progreso
set showmode        " Mostrar modo actual
set wildmenu        " Autocompletado de comandos mejorado
set laststatus=2    " Siempre mostrar statusline
set ruler           " Mostrar posición del cursor

" Split behavior
set splitbelow      " Split horizontal abajo
set splitright      " Split vertical a la derecha

" ============================================
" EDICIÓN
" ============================================

" Indentación
set tabstop=4       " Ancho de tab
set shiftwidth=4    " Ancho de indentación
set expandtab       " Usar espacios en lugar de tabs
set smartindent     " Indentación inteligente
set autoindent      " Mantener indentación

" Wrap
set wrap            " Ajustar líneas largas
set linebreak       " Romper en palabras completas

" Clipboard
set clipboard=unnamedplus  " Usar clipboard del sistema

" Backup y swap
set nobackup        " No crear backups
set noswapfile      " No crear swap files
" O guardarlos en directorio específico:
" set backupdir=~/.vim/backup
" set directory=~/.vim/swap

" Undo persistente
set undofile
set undodir=~/.vim/undo

" Mouse
set mouse=a         " Habilitar mouse

" Tiempo de espera
set timeoutlen=500  " Tiempo para secuencias de teclas

" ============================================
" MAPEOS
" ============================================

" Líder key
let mapleader = " "      " Usar espacio como líder
let maplocalleader = "," " Líder local

" Guardar con Ctrl+S
nnoremap <C-s> :w<CR>
inoremap <C-s> <Esc>:w<CR>

" Salir de Insert con jj
inoremap jj <Esc>

" Navegar entre ventanas más fácil
nnoremap <C-h> <C-w>h
nnoremap <C-j> <C-w>j
nnoremap <C-k> <C-w>k
nnoremap <C-l> <C-w>l

" Mover líneas
nnoremap <A-j> :m .+1<CR>==
nnoremap <A-k> :m .-2<CR>==
vnoremap <A-j> :m '>+1<CR>gv=gv
vnoremap <A-k> :m '<-2<CR>gv=gv

" Mantener selección al indentar
vnoremap < <gv
vnoremap > >gv

" Quitar highlight de búsqueda
nnoremap <leader><space> :nohlsearch<CR>

" Split rápido
nnoremap <leader>v :vsplit<CR>
nnoremap <leader>h :split<CR>

" Buffer navigation
nnoremap <leader>bn :bnext<CR>
nnoremap <leader>bp :bprevious<CR>
nnoremap <leader>bd :bdelete<CR>

" ============================================
" COLORES
" ============================================

" Tema (requiere instalación)
colorscheme desert  " Tema por defecto

" True color
if has('termguicolors')
    set termguicolors
endif

" ============================================
" AUTOCOMANDOS
" ============================================

augroup vimrc
    autocmd!
    " Volver a última posición al abrir archivo
    autocmd BufReadPost * if line("'\"") > 1 && line("'\"") <= line("$") | exe "normal! g'\"" | endif
    
    " Eliminar espacios al final al guardar
    autocmd BufWritePre * :%s/\s\+$//e
    
    " Resaltar yank
    autocmd TextYankPost * silent! lua vim.highlight.on_yank()
augroup END

" ============================================
" FUNCIONES PERSONALIZADAS
" ============================================

" Toggle números relativos
function! NumberToggle()
    if(&relativenumber == 1)
        set norelativenumber
    else
        set relativenumber
    endif
endfunction
nnoremap <leader>n :call NumberToggle()<CR>

" Persistencia
set hidden          " Permitir buffers ocultos con cambios

" Rendimiento
set lazyredraw      " No redibujar durante macros
set updatetime=300  " Tiempo de espera para swap/CursorHold

" Signos
set signcolumn=yes  " Siempre mostrar columna de signos

" Formato
set textwidth=80    " Ancho de texto
set colorcolumn=80  " Línea visual en columna 80

" Completion
set completeopt=menuone,noselect,noinsert

" Diff
set diffopt+=vertical  " Diff vertical

# Vim
curl -fLo ~/.vim/autoload/plug.vim --create-dirs \
    https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim

# Neovim
sh -c 'curl -fLo "${XDG_DATA_HOME:-$HOME/.local/share}"/nvim/site/autoload/plug.vim --create-dirs \
       https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim'

call plug#begin('~/.vim/plugged')

" Plugins aquí
Plug 'tpope/vim-surround'
Plug 'junegunn/fzf.vim'
Plug 'preservim/nerdtree'

call plug#end()

:PlugInstall    " Instalar plugins
:PlugUpdate     " Actualizar plugins
:PlugClean      " Eliminar plugins no usados
:PlugStatus     " Ver estado

-- ~/.config/nvim/lua/plugins.lua
return require('packer').startup(function(use)
    use 'wbthomason/packer.nvim'
    use 'tpope/vim-surround'
    use 'nvim-telescope/telescope.nvim'
end)

Plug 'preservim/nerdtree'

" Mapeo
nnoremap <C-n> :NERDTreeToggle<CR>

Plug 'junegunn/fzf', { 'do': { -> fzf#install() } }
Plug 'junegunn/fzf.vim'

" Mapeos
nnoremap <C-p> :Files<CR>
nnoremap <leader>b :Buffers<CR>
nnoremap <leader>g :Rg<CR>

Plug 'tpope/vim-surround'

" Comandos:
" ysiw" - Rodear palabra con "
" cs"' - Cambiar " por '
" ds" - Eliminar "
" yss) - Rodear línea con ()

Plug 'tpope/vim-commentary'

" Comandos:
" gcc - Comentar/descomentar línea
" gc{movimiento} - Comentar movimiento
" gcap - Comentar párrafo

Plug 'tpope/vim-repeat'
" Permite usar . con plugins

Plug 'tpope/vim-fugitive'

" Comandos:
:Git       " Git status
:Git add %
:Git commit
:Git push
:Gvdiffsplit  " Ver diff

Plug 'lewis6991/gitsigns.nvim'

Plug 'gruvbox-community/gruvbox'
Plug 'morhetz/gruvbox'
Plug 'dracula/vim'
Plug 'joshdick/onedark.vim'
Plug 'arcticicestudio/nord-vim'

colorscheme gruvbox

Plug 'vim-airline/vim-airline'
Plug 'vim-airline/vim-airline-themes'

let g:airline_theme='gruvbox'
let g:airline_powerline_fonts = 1

use {
    'nvim-lualine/lualine.nvim',
    requires = { 'kyazdani42/nvim-web-devicons' }
}

-- ~/.config/nvim/init.lua

-- Opciones básicas
vim.opt.number = true
vim.opt.relativenumber = true
vim.opt.expandtab = true
vim.opt.tabstop = 4
vim.opt.shiftwidth = 4
vim.opt.smartindent = true
vim.opt.wrap = false
vim.opt.swapfile = false
vim.opt.backup = false
vim.opt.undofile = true
vim.opt.hlsearch = false
vim.opt.incsearch = true
vim.opt.termguicolors = true
vim.opt.scrolloff = 8
vim.opt.signcolumn = "yes"
vim.opt.updatetime = 50
vim.opt.colorcolumn = "80"

-- Leader key
vim.g.mapleader = " "
vim.g.maplocalleader = ","

-- Mapeos
vim.keymap.set("n", "<leader>pv", vim.cmd.Ex)
vim.keymap.set("n", "<C-s>", ":w<CR>")
vim.keymap.set("i", "jj", "<Esc>")

-- Mover líneas
vim.keymap.set("v", "J", ":m '>+1<CR>gv=gv")
vim.keymap.set("v", "K", ":m '<-2<CR>gv=gv")

-- Mantener cursor centrado
vim.keymap.set("n", "<C-d>", "<C-d>zz")
vim.keymap.set("n", "<C-u>", "<C-u>zz")
vim.keymap.set("n", "n", "nzzzv")
vim.keymap.set("n", "N", "Nzzzv")

-- Navegar ventanas
vim.keymap.set("n", "<C-h>", "<C-w>h")
vim.keymap.set("n", "<C-j>", "<C-w>j")
vim.keymap.set("n", "<C-k>", "<C-w>k")
vim.keymap.set("n", "<C-l>", "<C-w>l")

-- Resaltar yank
vim.api.nvim_create_autocmd("TextYankPost", {
    group = vim.api.nvim_create_augroup("highlight_yank", { clear = true }),
    callback = function()
        vim.highlight.on_yank()
    end,
})

use {
    'nvim-treesitter/nvim-treesitter',
    run = ':TSUpdate'
}

require'nvim-treesitter.configs'.setup {
    ensure_installed = { "python", "javascript", "lua", "vim" },
    highlight = {
        enable = true,
    },
}

use {
    'nvim-telescope/telescope.nvim',
    requires = { 'nvim-lua/plenary.nvim' }
}

-- Mapeos
vim.keymap.set('n', '<leader>ff', ':Telescope find_files<CR>')
vim.keymap.set('n', '<leader>fg', ':Telescope live_grep<CR>')
vim.keymap.set('n', '<leader>fb', ':Telescope buffers<CR>')

use 'neovim/nvim-lspconfig'

-- Configurar servidor
local lspconfig = require('lspconfig')

-- Python
lspconfig.pyright.setup{}

-- JavaScript/TypeScript
lspconfig.tsserver.setup{}

-- Lua
lspconfig.lua_ls.setup{
    settings = {
        Lua = {
            diagnostics = {
                globals = { 'vim' }
            }
        }
    }
}

-- Después de attach LSP
local opts = { noremap=true, silent=true }
vim.keymap.set('n', 'gD', vim.lsp.buf.declaration, opts)
vim.keymap.set('n', 'gd', vim.lsp.buf.definition, opts)
vim.keymap.set('n', 'K', vim.lsp.buf.hover, opts)
vim.keymap.set('n', 'gi', vim.lsp.buf.implementation, opts)
vim.keymap.set('n', '<C-k>', vim.lsp.buf.signature_help, opts)
vim.keymap.set('n', '<leader>rn', vim.lsp.buf.rename, opts)
vim.keymap.set('n', '<leader>ca', vim.lsp.buf.code_action, opts)
vim.keymap.set('n', 'gr', vim.lsp.buf.references, opts)

use 'hrsh7th/nvim-cmp'
use 'hrsh7th/cmp-nvim-lsp'
use 'hrsh7th/cmp-buffer'
use 'hrsh7th/cmp-path'
use 'L3MON4D3/LuaSnip'

local cmp = require'cmp'

cmp.setup({
    snippet = {
        expand = function(args)
            require('luasnip').lsp_expand(args.body)
        end,
    },
    mapping = {
        ['<C-p>'] = cmp.mapping.select_prev_item(),
        ['<C-n>'] = cmp.mapping.select_next_item(),
        ['<C-d>'] = cmp.mapping.scroll_docs(-4),
        ['<C-f>'] = cmp.mapping.scroll_docs(4),
        ['<C-Space>'] = cmp.mapping.complete(),
        ['<C-e>'] = cmp.mapping.close(),
        ['<CR>'] = cmp.mapping.confirm({ select = true }),
    },
    sources = {
        { name = 'nvim_lsp' },
        { name = 'buffer' },
        { name = 'path' },
    }
})

let variable = "valor"
let g:global_var = 1
let l:local_var = 2
let s:script_var = 3

if condición
    " código
elseif otra_condición
    " código
else
    " código
endif

for item in lista
    " código
endfor

while condición
    " código
endwhile

function! MiFuncion(arg1, arg2)
    " código
    return resultado
endfunction

" Llamar
call MiFuncion(1, 2)

local variable = "valor"
vim.g.global_var = 1

if condición then
    -- código
elseif otra_condición then
    -- código
else
    -- código
end

for i = 1, 10 do
    -- código
end

for key, value in pairs(tabla) do
    -- código
end

local function mi_funcion(arg1, arg2)
    -- código
    return resultado
end

:args *.js          " Cargar todos los .js
:argdo %s/old/new/g | update  " Reemplazar en todos

:bufdo %s/old/new/g | update

:vimgrep /patrón/ **/*.py   " Buscar en archivos
:copen                      " Abrir quickfix list
:cn                         " Siguiente
:cp                         " Anterior

Ctrl+a      " Incrementar número bajo cursor
Ctrl+x      " Decrementar

# En visual block:
g Ctrl+a    " Incrementar secuencialmente

# En insert mode:
Ctrl+r =2+2<CR>  " Inserta resultado (4)

gqap        " Format paragraph
gwap        " Format and keep cursor position

:%!python -m json.tool     " JSON
:%!xmllint --format -      " XML
:% !prettier --parser babel  " JavaScript

:vert diffsplit archivo2
:diffthis       " Marcar ventana actual para diff
:diffoff        " Desactivar diff
]c              " Siguiente cambio
[c              " Cambio anterior
do              " Diff obtain (obtener cambio)
dp              " Diff put (poner cambio)

:mksession ~/sesion.vim

:source ~/sesion.vim
# O al iniciar:
vim -S ~/sesion.vim

:set spell spelllang=es    " Activar corrector español
:set spell spelllang=en    " Inglés

]s      " Siguiente error
[s      " Error anterior
z=      " Sugerencias
zg      " Añadir palabra a diccionario
zw      " Marcar palabra como mal escrita

gx      " Abrir URL bajo cursor en navegador

:.!sh   " Ejecutar línea actual como comando shell

# Seleccionar tabla en visual
:!column -t     " Alinear columnas

" Deshabilitar plugins temporalmente
vim --noplugin

" Ver tiempo de inicio
vim --startuptime tiempo.log

" Lazy loading de plugins
Plug 'plugin/name', { 'on': 'Comando' }

" Reducir updatetime
set updatetime=300

:echo has('clipboard')  " Debe retornar 1

sudo apt install vim-gtk3
# O para Neovim:
sudo apt install xclip

" Habilitar true color
set termguicolors

" O verificar $TERM
echo $TERM  " Debe ser xterm-256color o similar

:checkhealth        " Diagnóstico completo
:LspInfo            " Info de LSP

" Instalar servidor manualmente
:LspInstall pyright

" vim-plug
:PlugInstall
:PlugUpdate

" Verificar errores
:messages

:set verbose=9      " Nivel de verbosidad
:set verbosefile=~/vim_debug.log

:set all            " Ver todas las opciones
:set opción?        " Ver valor de opción específica

:map                " Ver todos los mapeos
:nmap               " Mapeos en modo Normal
:imap               " Mapeos en modo Insert