Conocer los comandos fundamentales de la CLI de .NET y saber organizar un proyecto desde el inicio marca la diferencia entre escribir código que funciona y construir software mantenible. Aquí se desglosan los comandos esenciales, la estructura de carpetas recomendada y la configuración de metadatos que todo desarrollador en C# necesita dominar.
¿Qué comandos de la CLI de .NET debes conocer primero?
La CLI (Command Line Interface) de .NET es la herramienta principal para interactuar con el ecosistema desde la terminal. Antes de escribir una sola línea de código, conviene verificar el entorno de trabajo con estos comandos:
dotnet --version: muestra la versión instalada del SDK, ideal para confirmar compatibilidad con un proyecto. [00:17]dotnet --info: despliega información completa del runtime, sistema operativo y arquitectura. [00:26]dotnet new list: lista todas las plantillas disponibles para crear proyectos. [00:35]
Las plantillas o templates son estructuras predefinidas de archivos que .NET genera automáticamente según el tipo de aplicación. No solo existe console; también están classlib para bibliotecas de clases, webapi para servicios REST, blazor para interfaces web y maui para aplicaciones multiplataforma. Cada una produce una estructura de archivos optimizada para su propósito. [00:44]
¿Cuál es la diferencia entre build y run?
Estos dos comandos se confunden con frecuencia, pero cumplen roles distintos:
dotnet build: solo compila el proyecto y genera los archivos en la carpeta bin. No ejecuta nada. Es útil cuando quieres verificar que el código compila correctamente sin lanzar la aplicación. [01:02]dotnet run: compila y ejecuta el programa en un solo paso.
Al ejecutar dotnet build, la terminal confirmó que el proceso se completó en fracciones de segundo, generando el archivo InventarioApp.dll dentro de bin/debug/net10. [01:17]
¿Cómo organizar la estructura de un proyecto en .NET?
Un proyecto funcional pero desorganizado genera problemas a medida que crece. La recomendación profesional es crear una carpeta src (abreviatura de source) que almacene todo el código fuente. [01:35]
Otras carpetas habituales en proyectos bien estructurados:
test: contiene las pruebas automatizadas.docs: almacena la documentación del proyecto.
¿Qué metadatos se configuran en el archivo .csproj?
El archivo .csproj es el corazón de cualquier proyecto .NET. Dentro del bloque PropertyGroup se definen los metadatos clave: [01:50]
AssemblyName: nombre del ejecutable generado.RootNamespace: el namespace raíz que organiza todo el código.Version: versión actual del proyecto, por ejemplo 1.0.0.0.Description: descripción breve de la funcionalidad.
Un namespace funciona como una carpeta, pero para código. Su propósito principal es evitar conflictos entre nombres de clases cuando un proyecto crece o utiliza múltiples bibliotecas. [02:23]
¿Cómo leer metadatos del .csproj desde el código?
Para verificar que la configuración y el código trabajan en conjunto, se puede usar Assembly.GetExecutingAssembly() desde la librería System.Reflection, que se importa automáticamente al escribir la instrucción. [02:34]
Este método permite leer en tiempo de ejecución la versión configurada en el .csproj y mostrarla con Console.WriteLine. Al ejecutar dotnet run, la consola imprimió 1.0.0.0, confirmando que metadatos y código están sincronizados. [03:06]
Un detalle importante: la versión debe seguir el formato de versionado semántico con valores numéricos. Al reemplazar los números por letras de forma deliberada y ejecutar dotnet run, el programa falló inmediatamente. Restaurar el formato correcto (1.0.0.0) resolvió el error. [03:25]
¿Por qué importa el orden de las instrucciones en C#?
Como ejercicio práctico, se presentó un bloque de código desordenado cuya solución correcta sigue esta secuencia: [04:06]
- Importar las librerías necesarias.
- Declarar variables utilizando los métodos correspondientes.
- Imprimir en consola el resultado esperado.
El orden de ejecución no es opcional: en programación, cada línea depende de lo que se declaró antes. Saltarse este principio produce errores de compilación o comportamientos inesperados.
Si ya dominas estos comandos y la estructura básica, el siguiente paso natural es incorporar control de versiones para proteger cada avance del proyecto. ¿Qué comando de la CLI te resultó más útil? Comparte tu experiencia.
