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 web; 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 después el instalador que caerá 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 abrirá VS Code mostrando una ventana con una barra lateral fina a la izquierda y un editor central en blanco. Si el botón no coincide exactamente, busca un enlace que diga "Other platforms" o "Get VS Code for…". Sabrás que funcionó cuando el icono de VS Code aparezca en tu escritorio o en tu 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 pequeño con una silueta: es el botón Accounts (piensa en él como la puerta que permite a VS Code conocer tu identidad online). Haz clic; se desplegará un pequeño panel con la opción "Sign in with GitHub". Elígela; tu navegador por defecto se abrirá y te pedirá que confirmes el inicio de sesión. Tras aprobarlo, el panel desaparece y una pequeña foto de perfil o tus iniciales reemplazan a la silueta. Si no ves la silueta, abre la barra de menú, elige View → Command Palette, escribe "Sign in" y escoge la opción que menciona GitHub. Sabrás que funcionó cuando tu nombre de usuario o avatar de GitHub aparezca en la esquina inferior izquierda de VS Code.

Instala la extensión de GitHub Copilot

En la barra lateral izquierda busca un icono que parece cuatro cuadrados en forma de cuadrícula: abre la vista Extensions (imagínatelo como una mini tienda de apps 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. Pulsa Install; VS Code descargará la extensión y la activará automáticamente. Cuando el proceso termine, aparecerá un nuevo logo de GitHub Copilot (normalmente una burbuja de chat estilizada) en la barra de actividad: la tira vertical finita en el extremo izquierdo. Si no ves el icono de los cuatro cuadrados, también puedes abrir View → Extensions desde el menú superior. Sabrás que funcionó cuando la lista de extensiones muestre GitHub Copilot como "Enabled" y el icono de Copilot aparezca 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: parece 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 solo clic sobre el archivo para seleccionarlo y luego doble clic para abrirlo; el contenido del archivo rellenará el área central del editor y aparecerá una columna con los números de línea a la izquierda. (Una función es simplemente un conjunto de instrucciones con nombre, como una ficha de receta, y un comentario es una nota para los 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 funcionó 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 encima de 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 breve, como // Explica qué hace esta línea. En muchos casos, GitHub Copilot mostrará una sugerencia tenue en color gris, el llamado ghost text, justo después de que termines de escribir: es el comportamiento de autocompletado en línea de Copilot. Si aparece el ghost text, pulsa Tab para convertirlo en un comentario real; pulsa Escape si quieres descartarlo y probar con otro prompt.

Si no aparece ningún ghost text, puede ser porque la instrucción es demasiado corta o la extensión necesita un momento para cargar. En ese caso puedes usar el comando integrado como alternativa: abre la Paleta de comandos (Ctrl+Shift+P / Cmd+Shift+P) y ejecuta "GitHub Copilot: Explain". Copilot insertará entonces un comentario basado en la línea que tengas seleccionada.

Sabrás que funcionó 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, simplemente haz clic dentro de la línea del comentario y escribe la corrección: Copilot no aprende de estos cambios, así que los retoques manuales son lo normal. Para terminar, guarda el archivo pulsando Ctrl+S (o Cmd+S en macOS); el puntito al lado del nombre del archivo en la pestaña desaparece, indicando que se ha guardado. Si notas que el comentario sigue sin estar claro, vuelve al Paso 5 y reformula tu prompt (por ejemplo, Resume el paso del cálculo de impuestos en lenguaje sencillo).