Cómo añadir comentarios útiles a tu código con GitHub Copilot — guía para principiantes

Descarga e instala Visual Studio Code

Entra en code.visualstudio.com desde cualquier navegador; verás un botón grande que normalmente dice "Download for Windows", "Download for macOS" o "Download for Linux". Haz clic en ese botón y abre el instalador que habrá caído en tu carpeta de Descargas (termina en .exe, .dmg, .deb o .rpm). El instalador te lleva por unas pocas pantallas — solo tienes que hacer clic en "Next", aceptar la licencia y pulsar "Install". Cuando termine, se abre VS Code y aparece una ventana con una barra lateral fina a la izquierda y un editor en blanco en el centro. Si el botón no encaja del todo, busca un enlace que diga "Other platforms" o "Get VS Code for …". Sabrás que todo ha ido bien cuando veas el icono de VS Code en tu escritorio o en la carpeta de aplicaciones y el programa se abra con un editor vacío.

Inicia sesión en GitHub desde VS Code

Con VS Code abierto, mira la esquina inferior izquierda; deberías ver un icono con una silueta pequeña — es el botón Accounts (piensa en él como la puerta que permite a VS Code conocer tu identidad online). Haz clic ahí; se desplegará un pequeño panel con la opción "Sign in with GitHub". Elígela; tu navegador predeterminado se abrirá y te pedirá que confirmes el inicio de sesión. Tras aprobarlo, el panel desaparece y la silueta se reemplaza por un avatar o por tus iniciales. Si no ves la silueta, abre la barra de menú, elige View → Command Palette, escribe "Sign in" y selecciona la opción que menciona GitHub. Sabrás que ha funcionado cuando tu nombre de usuario o avatar de GitHub aparezca en la esquina inferior izquierda de VS Code.

Instala la extensión GitHub Copilot

En la barra lateral izquierda, busca un icono con forma de cuatro cuadrados formando una cuadrícula — abre la vista Extensions (imagínatela como una mini tienda de aplicaciones integrada en VS Code). Haz clic en el icono; aparecerá un panel con una barra de búsqueda arriba. Escribe GitHub Copilot en esa barra. El primer resultado es la extensión oficial de Copilot, con un botón Install al lado. Haz clic en Install; VS Code descargará la extensión y la activará automáticamente. Cuando termine, aparece un nuevo logo de Copilot (normalmente una burbuja de chat estilizada) en la barra de actividad — la franja vertical finita del extremo izquierdo. Si no encuentras el icono de los cuatro cuadrados, también puedes abrir View → Extensions desde el menú superior. Sabrás que ha funcionado cuando en la lista de extensiones aparezca GitHub Copilot como "Enabled" y el icono de Copilot se muestre en la barra de actividad.

Abre un archivo de código en el editor

Haz clic en el primer icono de la barra lateral izquierda — parecen dos páginas apiladas y representa el Explorer (piensa en él como un explorador de carpetas). En el panel del Explorer, navega hasta una carpeta que contenga un archivo como example.js o notes.txt. Haz un clic simple en el archivo para seleccionarlo y, después, doble clic para abrirlo; el contenido del archivo rellenará el editor central y aparecerá una columna de números de línea a la izquierda. (Una función no es más que un conjunto con nombre de instrucciones, como una ficha de receta, y un comentario es una nota para lectores humanos que el ordenador ignora en silencio.) Si el Explorer no está visible, pulsa Ctrl+Shift+E (en macOS, Cmd+Shift+E). Sabrás que ha funcionado cuando el texto del archivo aparezca en el editor con los números de línea bajando por el lado izquierdo.

Pídele a GitHub Copilot que sugiera un comentario sobre una línea de código

Coloca el cursor en una línea vacía justo encima de la línea que quieres explicar. Escribe // seguido de una instrucción corta, por ejemplo Explain what this line does. En muchos casos, GitHub Copilot mostrará un ghost text (texto fantasma) tenue en gris justo al terminar de escribir — es el comportamiento de autocompletado en línea de Copilot. Si aparece el texto fantasma, pulsa Tab para convertirlo en un comentario real; pulsa Escape si prefieres descartarlo y probar con otra indicación.

Si no aparece ningún texto fantasma, puede ser porque la instrucción es demasiado corta o la extensión necesita un momento para cargar. En ese caso puedes recurrir al comando integrado como alternativa: abre la Command Palette (Ctrl+Shift+P / Cmd+Shift+P) y ejecuta "GitHub Copilot: Explain" (el nombre exacto del comando puede variar ligeramente). Copilot insertará entonces un comentario basado en la línea que tengas seleccionada.

Sabrás que ha funcionado cuando aparezca un comentario legible encima de la línea objetivo, resumiendo su propósito en lenguaje claro.

Revisa, edita y guarda la sugerencia

Lee en voz alta el comentario recién insertado; si describe bien el código, has terminado. Si la redacción no convence, solo tienes que hacer clic en la línea del comentario y escribir la corrección — Copilot no aprende de estas ediciones, así que los retoques manuales son lo normal. Para terminar, guarda el archivo pulsando Ctrl+S (o Cmd+S en macOS); el punto junto al nombre del archivo en la pestaña desaparece, lo que indica que el archivo está guardado. Si notas que el comentario sigue sin ser claro, vuelve al Paso 5 y reformula tu indicación (por ejemplo, Summarise the tax‑calculation step in plain English).