5 Comandos Rápidos de .NET CLI que Cada Desarrollador C# Debería Saber

Introducción al CLI de .NET y la interfaz de línea de comandos .NET

Al inicio del video, Tim enfatiza que incluso si prefieres un IDE como Visual Studio, entender la interfaz de línea de comandos (CLI) de .NET es crucial. Una interfaz de línea de comandos CLI te permite interactuar con tus aplicaciones .NET Core directamente, sin depender del IDE. Esto es especialmente útil cuando deseas ejecutar comandos de lanzamiento, realizar compilaciones explícitas o trabajar en un entorno de herramientas multiplataforma usando Windows, Mac o Linux.

Tim también ofrece un consejo rápido extra a las 1:15: ejecuta

dotnet --info

Este comando lista las versiones SDK de .NET instaladas, los paquetes de ejecución en la tienda de paquetes de ejecución, la arquitectura y otros detalles del entorno. Confirma que el CLI de .NET Core está instalado y listo para usar, lo cual es esencial antes de explorar más comandos.

1. Construye tu proyecto con dotnet build

El primer comando que Tim explica es dotnet build. Este comando de construcción compila tu código fuente en archivos DLL en el directorio de salida, generalmente bajo bin/Debug/net10/ o bin/Release/net10/. Tim demuestra limpiar el directorio bin para eliminar archivos compilados previamente, asegurando una compilación limpia.

dotnet build

Tim explica que este comando crea la salida compilada basada en el archivo de configuración y la plantilla de proyecto, ya sea una aplicación de consola, una biblioteca de clases, o una aplicación ASP.NET Core. El comando de construcción es esencial porque asegura que tu CLI de .NET Core sepa exactamente qué compilar y qué archivos especificados incluir.

Usar el comando de construcción también es un requisito previo para comandos de CLI más avanzados como dotnet run o dotnet publish. Tim enfatiza que aunque Visual Studio maneja las construcciones automáticamente, conocer la opción de compilación explícita con dotnet build ayuda en los pipelines de CI/CD o en flujos de trabajo básicos de línea de comandos.

2. Ejecuta tu aplicación con dotnet run

El segundo comando de Tim es dotnet run, un comando de ejecución que construye y ejecuta tu aplicación .NET Core en un solo paso. A diferencia de dotnet build, que solo compila, dotnet run ejecuta la aplicación en el terminal o símbolo del sistema actual.

dotnet run

Usando su aplicación web Blazor, Tim demuestra que dotnet run lanza la aplicación basado en el archivo launchSettings.json. La URL predeterminada y el puerto HTTP se seleccionan automáticamente. Edita la página de inicio usando Notepad, y señala que las actualizaciones no se reflejan hasta volver a ejecutar dotnet run (5:02).

Este comando es especialmente útil para probar aplicaciones de consola, aplicaciones web ASP.NET Core, e incluso proyectos de bibliotecas de clases que referencian otros archivos DLL usando dotnet add reference. Para los desarrolladores que ejecutan pruebas unitarias en .NET Core, combinar dotnet build con dotnet run asegura que los ensamblajes especificados estén listos para el ejecutor de pruebas.

3. Recarga caliente con dotnet watch

Para eliminar la necesidad de reiniciar tu aplicación después de cada cambio, Tim introduce dotnet watch, un comando CLI de observador de archivos que habilita la recarga caliente (5:44).

dotnet watch

Esta interfaz de línea de comandos CLI monitorea archivos específicos en tu directorio de proyecto y aplica automáticamente cambios a la aplicación en ejecución. Tim edita la página de inicio nuevamente, cambiando el texto de "Hello YouTube" de nuevo a "Hello World", y el navegador se actualiza en tiempo real sin reiniciar.

La función de observación de archivos es invaluable para el desarrollo multiplataforma, permitiendo a los desarrolladores de .NET Core trabajar en editores ligeros como Notepad mientras mantienen la experiencia de recarga caliente típicamente disponible solo en Visual Studio o VS Code.

4. Limpia tu proyecto con dotnet clean

A veces, los proyectos .NET pueden tener archivos compilados remanentes que causan errores o inconsistencias. El cuarto comando de Tim, dotnet clean, elimina todos los archivos en el directorio de salida y carpetas intermedias, como bin/ y obj/ (7:06).

dotnet clean

Después de ejecutar este comando, las construcciones subsiguientes se realizan desde cero, asegurando que no interfieran archivos DLL o recursos locales NuGet. Tim demuestra que dotnet clean es particularmente útil cuando se trata con archivos de solución que contienen múltiples proyectos .NET Core o proyectos de bibliotecas de clases con paquetes NuGet.

Este comando asegura un comienzo limpio para ejecutar pruebas unitarias con dotnet test o para preparar el proyecto para el despliegue.

5. Publica tu proyecto con dotnet publish

Finalmente, Tim introduce dotnet publish, que prepara tu aplicación .NET Core para su despliegue en un sistema de hosting como IIS, Azure, u otros entornos.

dotnet publish

Este comando CLI compila el proyecto y coloca los activos publicados en la carpeta publish bajo bin/Release/net10/. La salida incluye todos los ensamblajes especificados, paquetes de ejecución, y los certificados de desarrollo necesarios para el hosting. Tim enfatiza que este comando funciona para todos los proyectos .NET Core, incluidas aplicaciones de consola, aplicaciones ASP.NET Core, y bibliotecas de clases (8:18).

dotnet publish también es útil cuando se combina con dotnet pack para crear paquetes NuGet, haciendo que tu código sea reutilizable en múltiples soluciones .NET Core.

Consejos y notas adicionales

Tim destaca que dominar estos cinco comandos CLI de .NET Core—dotnet build, dotnet run, dotnet watch, dotnet clean, y dotnet publish—cubre aproximadamente el 85% de las tareas diarias en el desarrollo de .NET Core (9:01). También menciona otras opciones de comandos y documentación más detallada en línea si deseas explorar banderas avanzadas, ejecutores de pruebas unitarias, o plantillas de proyectos personalizadas.

Para nuevos proyectos, los desarrolladores pueden usar dotnet new console, dotnet new class library, u otras plantillas especificadas para generar rápidamente una aplicación de consola .NET Core o un proyecto ASP.NET Core. Además, dotnet restore ayuda a restaurar recursos locales NuGet y ensamblajes especificados antes de construir.

Estos comandos son multiplataforma, lo que significa que la misma interfaz de línea de comandos CLI funciona en Windows, Mac y Linux. También son compatibles con plantillas de proyectos, archivos de solución, aplicaciones de consola, proyectos de bibliotecas de clases, y aplicaciones modelo-vista-controlador, haciéndolos versátiles para casi todos los proyectos .NET Core.

Resumen

Aquí hay un resumen rápido de los cinco comandos CLI esenciales de .NET Core que recomienda Tim Corey:

1. dotnet build – Compila explícitamente tu proyecto en archivos DLL en el directorio de salida.

2. dotnet run – Construye y ejecuta la aplicación .NET Core inmediatamente.

3. dotnet watch – Habilita la recarga caliente vía un observador de archivos para reflejar cambios automáticamente.

4. dotnet clean – Elimina todos los archivos compilados y carpetas intermedias para una construcción limpia.

5. dotnet publish – Prepara una aplicación de .NET Core completamente publicada para su despliegue en cualquier sistema de alojamiento.

Estos comandos empoderan a los desarrolladores para gestionar proyectos .NET Core, archivos de solución, y proyectos de consola eficientemente usando el CLI de .NET sin depender completamente de un IDE. Al incorporarlos en tu flujo de trabajo, puedes construir, ejecutar, probar y desplegar rápidamente tus aplicaciones .NET Core con confianza.