Categorías
Noticias

GitLens: Descubre quién, cuándo y por qué cambió cada línea de código

GitLens: Descubre quién, cuándo y por qué cambió cada línea de código

3 minutos de lectura • Nivel: Principiante

¿Alguna vez te has encontrado con código extraño y te has preguntado «¿Quién escribió esto?» o «¿Por qué está así?» GitLens es la respuesta. Es la extensión más popular de VS Code para Git, con más de 25 millones de descargas, y hoy te enseño a usarla.

¿Qué hace GitLens?

GitLens supercarga las capacidades de Git en VS Code, mostrando información valiosa directamente en tu editor:

  • 👤 Quién modificó cada línea
  • 📅 Cuándo se hizo el cambio
  • 💬 Por qué (mensaje del commit)
  • 🔍 Historial completo del archivo

Instalación (30 segundos)

  1. Abre VS Code o Cursor
  2. Presiona Ctrl + Shift + X
  3. Busca «GitLens»
  4. Haz clic en Install

O desde la terminal:

code --install-extension eamodio.gitlens

Configuración Recomendada

Abre la configuración de VS Code (Ctrl + , → ícono de JSON arriba a la derecha) y agrega esto:

{
  "gitlens.currentLine.enabled": true,
  "gitlens.hovers.currentLine.over": "line",
  "gitlens.blame.annotations.enabled": true,
  "gitlens.blame.file.line.annotationType": "gutter",
  "gitlens.blame.format": "${date}",
  "gitlens.blame.dateFormat": "DD/MM/YYYY"
}

Esta configuración muestra solo la fecha del último cambio en el margen izquierdo (gutter), manteniendo tu código limpio y legible.

Toggle File Blame: La Función Estrella ⭐

Esta es la funcionalidad que usarás todos los días. Te permite activar/desactivar el historial de Git con un clic.

¿Cómo usarla?

  • Opción 1: Haz clic en el ícono 👤 en la esquina superior derecha del editor
  • Opción 2: Ctrl + Shift + P → escribe «Toggle File Blame»

¿Qué verás?

Una vez activado, cada línea muestra cuándo fue modificada por última vez:

05/11/2025  |  function calculateTotal(price) {
03/10/2025  |    const tax = 0.21;
05/11/2025  |    return price * (1 + tax);
01/09/2025  |  }

Esto te dice que las líneas 1 y 3 se modificaron recientemente (05/11), mientras que la línea del cálculo del IVA es de hace un mes, y el cierre de la función es del código original (01/09).

Ver Más Detalles

Pasa el mouse sobre cualquier fecha y verás:

  • Nombre completo del autor
  • Hora exacta del cambio
  • Mensaje del commit completo
  • Hash del commit
  • Enlaces para ver el diff o abrir el archivo en esa versión

Tres Estilos de Configuración

Según tu preferencia, puedes configurar GitLens de diferentes formas:

1️⃣ Minimalista (Solo Fechas)

{
  "gitlens.blame.format": "${date}",
  "gitlens.blame.dateFormat": "DD/MM/YYYY"
}

Resultado: 05/11/2025 | código

2️⃣ Con Autor

{
  "gitlens.blame.format": "${date} • ${author}",
  "gitlens.blame.dateFormat": "DD/MM/YY"
}

Resultado: 05/11/25 • Felix | código

{
  "gitlens.blame.format": "${agoOrDate}"
}

Resultado: hace 2 días | código

Casos de Uso Reales

1. Entender Código Legacy 📚

Te encuentras con:

const MAGIC_NUMBER = 42;

Con GitLens descubres que fue escrito hace 3 años con el mensaje: «Fix temporal para bug #1234». Ahora tiene sentido.

2. Code Review Rápido ⚡

Activas el blame y ves qué líneas son nuevas (fecha de hoy). Revisas solo esos cambios en lugar de todo el archivo.

3. Debugging 🐛

Hay un bug. Ves quién modificó esa línea por última vez, lees el commit, y entiendes qué cambió y por qué.

Tips Rápidos 💡

  • Tip 1: Crea un atajo de teclado para Toggle File Blame
    Ctrl + K, Ctrl + S → Busca «Toggle File Blame» → Asigna Ctrl + Alt + B
  • Tip 2: Haz clic en una fecha del gutter para ver el diff de ese commit
  • Tip 3: Si molesta, simplemente haz clic de nuevo en el ícono 👤 para desactivarlo
  • Tip 4: Clic derecho en el gutter → «Show Commits from [Autor]» para filtrar por persona

Problemas Comunes

No veo información de blame:

  • Verifica que el archivo está en Git
  • Haz clic en el ícono 👤 para activarlo manualmente

La información molesta al final de cada línea:

  • Cambia "gitlens.blame.file.line.annotationType": "gutter"

VS Code va lento con GitLens:

{
  "gitlens.codeLens.enabled": false,
  "gitlens.blame.avatars": false
}

Conclusión

GitLens transforma tu experiencia con Git de algo que usas en la terminal a información contextual integrada en tu editor. La función Toggle File Blame te permite ver el historial de cualquier archivo en segundos.

Mi recomendación: Úsalo durante una semana. Una vez que te acostumbras, es imposible trabajar sin él.

Configuración Completa Copy-Paste 📋

{
  "gitlens.currentLine.enabled": true,
  "gitlens.hovers.currentLine.over": "line",
  "gitlens.blame.annotations.enabled": true,
  "gitlens.blame.file.line.annotationType": "gutter",
  "gitlens.blame.format": "${date}",
  "gitlens.blame.dateFormat": "DD/MM/YYYY",
  "gitlens.blame.compact": false
}

¿Usas GitLens? ¿Cuál es tu configuración favorita?
Déjalo en los comentarios 👇

Publicado el 13 de Noviembre, 2025

Tags:

Deja un comentario