Encontrar y corregir errores en el código puede ser frustrante, especialmente si acabas de empezar como desarrollador. Afortunadamente, herramientas como GitHub Copilot pueden identificar y solventar rápidamente los errores, lo que te permite centrarte en un trabajo más creativo e interesante.
Requisitos previos
En los ejemplos de este artículo, se asume que estás usando GitHub Copilot para depurar un proyecto en Python en Visual Studio Code (VS Code). Para seguir los ejemplos, debes:
- Complete la configuración de Visual Studio Code con Copilot en la documentación de Visual Studio Code.
-
[Download Python](https://www.python.org/downloads/). - Instale la extensión Python para Visual Studio Code.
Aprender a depurar a través de ejemplos
Hay dos situaciones principales que encontrarás al intentar ejecutar código con errores:
- El código se cierra antes de que termine de ejecutarse y recibirás un mensaje de error.
- El código se ejecuta sin errores, pero la salida es diferente de la esperada.
Afortunadamente, Copilot puede ayudar a depurar el código en ambas situaciones. Para obtener información sobre cómo hacerlo, consulta los ejemplos siguientes.
Depuración de errores con GitHub Copilot
Al ejecutar código con errores, a menudo recibirás un mensaje de error. El mensaje te indica el archivo y la línea donde se produjo el error y describe brevemente lo que salió mal. Sin embargo, los mensajes de error pueden resultar confusos. Para comprender y corregir completamente el error, podemos pedir ayuda a Copilot.
Vamos a probar esto con un repositorio de ejemplo: new2code/debug-with-copilot.
Clonación del repositorio de ejemplos
En primer lugar, es necesario crear una copia local del repositorio:
-
[Empieza clonando el repositorio new2code/debug-with-copilot](vscode://vscode.git/clone?url=https://github.com/new2code/debug-with-copilot) en VS Code. <!-- markdownlint-disable-line GHD003 --> - Elige una ubicación para guardar el repositorio en el equipo y, a continuación, haz clic en Seleccionar como destino del repositorio.
- Cuando se te solicite, abre el repositorio.
Ejecución del archivo con errores
Ahora, vamos a ejecutar el archivo bugged_dice_battle.py. Este programa simula una batalla de dados entre dos jugadores.
-
En VS Code, abre y revise el archivo
bugged_dice_battle.py. -
Abra la paleta de comandos presionando Ctrl+Shift+P (Windows o Cmd+Shift+P (Mac).
-
Escriba
Terminal: Create New Terminaly presione Entrar. -
En la pestaña del terminal, pega el siguiente comando.
Windows:
Shell py bugged_dice_battle.py
py bugged_dice_battle.pyMac o Linux:
Shell python bugged_dice_battle.py
python bugged_dice_battle.py -
Presiona Entrar para ejecutar el programa.
Desafortunadamente, obtenemos un texto de error en nuestro terminal que termina con el siguiente mensaje:
TypeError: solo puede concatenar str (no "int") a str
Depuración del archivo
Para comprender lo que significa este error, abra Copilot Chat en VS Code y luego pegue y envíe la siguiente solicitud:
Explain in depth why my code produces the following error and how I can fix it: TypeError: can only concatenate str (not "int") to str
Explain in depth why my code produces the following error and how I can fix it:
TypeError: can only concatenate str (not "int") to str
Copilot responderá que se produce el error porque estamos intentando concatenar los enteros die_1 y die_2 en las cadenas, y solo se pueden concatenar cadenas en cadenas.
También proporcionará una versión actualizada del código que corrige el error mediante la función str() para convertir los enteros en cadenas antes de concatenarlos. Practica el paso final de depuración aplicando las sugerencias de Copilot al archivo.
Depuración de una salida incorrecta con GitHub Copilot
A veces, se ejecuta código con errores sin producir ningún error, pero la salida es claramente incorrecta. En este caso, la depuración puede ser más difícil porque VS Code no puede indicarle la ubicación ni la descripción del error.
Para estos errores "invisibles", Copilot es particularmente útil. Vamos a obtener cierta experiencia práctica con el otro archivo en nuestro repositorio de ejemplo: bugged_factorial_finder.py. Es un programa de Python que se supone que calcula un factorial.
Ejecución del archivo con errores
En primer lugar, vamos a ejecutar el programa para ver la salida incorrecta:
-
Abre y revisa el archivo
bugged_factorial_finder.py. -
En el terminal que creaste anteriormente, pega el siguiente comando. Windows:
Shell py bugged_factorial_finder.py
py bugged_factorial_finder.pyMac o Linux:
Shell python bugged_factorial_finder.py
python bugged_factorial_finder.py -
Presiona Entrar para ejecutar el programa.
Desafortunadamente, el código no funciona según lo esperado. Queremos que devuelva 720, el valor correcto de 6 factoriales, pero la salida es mucho mayor que esa.
Depuración del archivo
Para comprender lo que salió mal, abra Copilot Chat y envíe la siguiente solicitud:
Why is the output of this code so much higher than expected? Please explain in depth and suggest a solution.
Why is the output of this code so much higher than expected? Please explain in depth and suggest a solution.
Copilot señalará que, al estar usando el operador *=, en realidad estamos multiplicando factorial por iyfactorial. En otras palabras, estamos multiplicando por un factorial extra para cada iteración del bucle.
Para corregir este error, Copilot sugerirá código que quite el factorial extra de la ecuación o que cambie el operador *= a =. ¡Haz ese cambio ahora!
Depuración de tu propio proyecto
Ahora que has practicado la depuración de algunos programas sencillos con Copilot, puedes usar las mismas metodologías para buscar y corregir errores ocultos en tu propio trabajo.
Por ejemplo, para depurar un mensaje de error generado por el código, envía a Copilot la siguiente solicitud:
Explain in depth why my code produces the following error and how I can fix it: YOUR-ERROR-MESSAGE
Explain in depth why my code produces the following error and how I can fix it:
YOUR-ERROR-MESSAGE
De lo contrario, si estás depurando un resultado incorrecto, pregunta a Copilot por qué el resultado es incorrecto y cómo puedes corregirlo. Para obtener los mejores resultados, proporciona tanto contexto como sea posible sobre cómo la salida difiere de tus expectativas.
Con estas tácticas, tienes todo lo necesario para corregir errores en tu proyecto.
Pasos siguientes
A medida que continúes codificando, es probable que encuentres escenarios de problemas y errores específicos que son difíciles de depurar. Para ver una lista de posibles incidencias y ejemplos de solicitudes de Copilot Chat para corregirlas, consulte Depuración de errores.