Descarga y explora el proyecto base en C#

Resumen

Aprender a refactorizar código en C# empieza por tener un proyecto funcional pero imperfecto, y eso es justo lo que encontrarás en el repositorio base de este curso. Aquí preparamos el entorno, ejecutamos la aplicación de consola y detectamos las primeras señales de malas prácticas que iremos corrigiendo.

¿Cómo descargar el repositorio del curso de código limpio en C#?

El punto de partida está en GitHub, donde encontrarás el repositorio llamado Curso Código Limpio C#. Tienes dos caminos para obtenerlo:

  • Clonarlo desde la consola de Git si ya manejas la herramienta.
  • Usar la opción Download ZIP, descomprimir el archivo y abrir el código directamente.

Cualquiera de las dos opciones te deja con un proyecto de un solo archivo. Sí, un único archivo, pero con suficiente código para mostrar varios de los errores típicos que aparecen en proyectos reales.

¿Qué es refactoring en programación? Es el proceso de mejorar la estructura interna del código sin cambiar su comportamiento externo. El programa sigue haciendo lo mismo, pero queda más legible y mantenible.

¿Cómo ejecutar una aplicación de consola en .NET?

Una vez tengas el código abierto, abre la terminal dentro del proyecto y corre dos comandos básicos para compilar y ejecutar [0:54]:

bash dotnet build dotnet run

El primero compila la solución y el segundo arranca la aplicación. Verás que se trata de un gestor de tareas en consola con cuatro opciones disponibles.

¿Qué hace la aplicación de tareas del curso?

El menú te permite interactuar con una lista de tareas pendientes mediante estas acciones:

  1. Agregar una nueva tarea, por ejemplo Terminar el trabajo de la U.
  2. Remover una tarea existente seleccionando su número en la lista.
  3. Ver las tareas pendientes, que aparecen numeradas.
  4. Salir de la aplicación y terminar la ejecución.

Cuando agregas una tarea, el programa responde con el mensaje tarea registrada. Si eliminas la número dos, al volver a consultar el listado solo queda la primera. Todo funciona, y ese es justamente el punto.

¿Por qué un código que funciona puede tener malas prácticas?

Aquí viene lo interesante. El programa cumple su propósito sin errores: agrega, elimina, lista y cierra. Pero cuando abres el archivo y lees el código, aparecen señales que delatan una baja calidad estructural [3:27].

  • Variables con nombres cortos y poco descriptivos que no comunican su intención.
  • Opciones del menú nombradas como menú dos o menú tres, sin reflejar la acción que ejecutan.
  • Una estructura larga concentrada en un solo archivo, sin separación de responsabilidades.

La regla mental es simple: si necesitas invertir tiempo extra leyendo y analizando para entender qué hace una porción de código, hay algo que mejorar. El código debe contarte qué hace sin que tengas que descifrarlo.

¿Qué son las buenas prácticas en programación? Son convenciones y estándares de calidad que hacen que el código sea legible, mantenible y fácil de modificar por cualquier persona del equipo, no solo por quien lo escribió.

Con el proyecto descargado y ejecutándose en tu máquina, ya tienes la base para empezar a aplicar mejoras reales. La primera buena práctica que vas a trabajar es la de nombramiento, donde verás cómo elegir nombres de variables, métodos y opciones que comuniquen intención de inmediato. ¿Qué nombres cambiarías tú primero al ver este código? Cuéntame en los comentarios.