Ir al contenido
wannacode

Preparar tu computadora

En resumen: Para escribir C# instalas el .NET SDK y un editor, lo compruebas con dotnet --version y ejecutas tu primer programa.

Problema

Qué necesitas

Para escribir y ejecutar programas necesitas dos cosas:

  1. El .NET SDK (Software Development Kit, el kit de desarrollo de software): el compilador, el entorno de .NET que ejecuta los programas, las bibliotecas estándar y el comando dotnet.
  2. Un editor para tu código. Podrías escribir un programa en el Bloc de notas, pero un editor para programadores colorea el código, te da sugerencias y muestra los errores mientras escribes.

Si todavía no tienes una computadora en la que puedas instalar programas, para los primeros días basta con un editor en línea: busca compilador de C# online en internet. Las tareas del módulo «Fundamentos del lenguaje» también funcionan allí. Para los programas más grandes de más adelante necesitarás una instalación.

La idea

Instala el .NET 10 SDK

Usamos .NET 10. Es una versión con soporte a largo plazo (LTS): recibe correcciones hasta noviembre de 2028. Descárgala de dotnet.microsoft.com, en la sección Download.

  • Elige el SDK, no el Runtime. El Runtime solo ejecuta programas terminados, mientras que el SDK también puede construirlos.
  • Windows y macOS: descarga el instalador del .NET 10.0 SDK y ejecútalo.
  • Linux: en Ubuntu, el paquete viene con el sistema:
Terminal
sudo apt install dotnet-sdk-10.0

Si tienes una versión más antigua (.NET 8, por ejemplo), instala .NET 10 junto a ella: varias versiones conviven sin ningún problema.

Comprobación. Abre una terminal nueva (en Windows: PowerShell o el Símbolo del sistema) y escribe:

Terminal
dotnet --version

Deberías ver el número de versión. Los números después del 10.0 pueden ser distintos:

10.0.402

La idea

Elige un editor

Tres buenas opciones:

  • Visual Studio Community (solo Windows): gratuito para aprender y para proyectos personales. Durante la instalación, elige la carga de trabajo .NET desktop development (desarrollo de escritorio de .NET). El programa se ejecuta con el triángulo verde de arriba o con F5.
  • Rider, de JetBrains: funciona en Windows, macOS y Linux y es gratuito para uso no comercial, lo que incluye aprender.
  • Visual Studio Code con la extensión C# Dev Kit de Microsoft: un editor ligero para cualquier sistema.

Qué editor elijas no importa mucho. Importa más que te acostumbres a uno y lo uses todos los días.

Míralo

Tu primer programa en tu computadora

En la terminal, ve a la carpeta del curso y crea un proyecto nuevo:

Terminal
dotnet new console -o Hello
cd Hello

El comando crea una carpeta llamada Hello con dos archivos: Hello.csproj (la descripción del proyecto) y Program.cs (el código).

La plantilla pone en Program.cs una sola línea, Console.WriteLine("Hello, World!");, sin class ni Main. Es una forma corta que C# permite. En el curso escribimos la forma completa, porque en ella se ve dónde empieza el programa. Sustituye el contenido de Program.cs por esto:

Program.cs
class Program
{
    static void Main()
    {
        Console.WriteLine("¡Hola!");
    }
}
Salida
¡Hola!

Después ejecuta:

Terminal
dotnet run

dotnet run compila el proyecto y lo ejecuta. Se lanza desde la carpeta que contiene Hello.csproj.

Más precisamente, para curiosos
  • El comando dotnet run compila en la carpeta bin, y el programa compilado es Hello.dll. Si solo quieres compilar sin ejecutar, el comando es dotnet build.
  • En C# el nombre del archivo no tiene que coincidir con el de la clase, pero es un buen hábito.
  • La forma corta sin class Program ni Main se llama instrucciones de nivel superior (top-level statements). El compilador construye Main alrededor de esas líneas por su cuenta. La verás en ejemplos en internet.
  • Si la terminal de Windows muestra signos de interrogación o símbolos raros en lugar de caracteres como ¡, ñ o €, la terminal no está configurada para UTF-8. Escribe chcp 65001 y vuelve a ejecutar el programa. En los editores normalmente no hay este problema.

Pruébalo

Cámbialo y ejecútalo otra vez

Añade una segunda línea que imprima «Tu computadora está lista.», guarda el archivo y vuelve a ejecutar el programa. Deberías ver:

Salida
¡Hola!
Tu computadora está lista.

Si solo ves «¡Hola!», lo más probable es que el archivo no esté guardado. Aquí tienes el programa completo, por si te atascas:

Program.cs
class Program
{
    static void Main()
    {
        Console.WriteLine("¡Hola!");
        Console.WriteLine("Tu computadora está lista.");
    }
}

Por qué un cambio que no has guardado no llega al programa:

class Program
{
    static void Main()
    {
        Console.WriteLine("¡Hola!");
        Console.WriteLine("Tu computadora está lista.");
    }
}
Paso a paso, en palabras
  1. El editor y el archivo en el disco tienen solo la primera línea.
  2. Ejecutas dotnet run: el programa se construye a partir del archivo en el disco.
  3. Añades una segunda línea en el editor. El archivo en el disco sigue siendo el antiguo.
  4. Lo ejecutas sin guardar: sigues obteniendo solo «¡Hola!».
  5. Guardas (Ctrl+S): el editor escribe el texto en el archivo en el disco.
  6. Lo ejecutas otra vez: ahora el programa ve también la segunda línea.

La idea

Cuando no arranca

  • «'dotnet' is not recognized…» (Windows) o «command not found» (macOS, Linux): la terminal no encuentra .NET. Ciérrala y abre una nueva, porque la antigua no ve los cambios de la instalación.
  • «Couldn't find a project to run»: estás ejecutando dotnet run desde la carpeta equivocada. Entra en la carpeta con el archivo .csproj (cd Hello).
  • «No .NET SDKs were found»: solo está instalado el Runtime. Instala el SDK.
  • «error CS…» con un número de línea: el programa ha llegado al compilador, así que la instalación está bien. Compara tu código con el ejemplo carácter por carácter.

En resumen

En resumen

  • Necesitas el .NET 10 SDK y un editor: Visual Studio Community, Rider o VS Code con el C# Dev Kit.
  • dotnet --version muestra si .NET está instalado.
  • dotnet new console -o Hello crea un proyecto, y dotnet run lo compila y lo ejecuta.
  • Si la terminal no encuentra el comando, abre una terminal nueva.

Lo siguiente es la lección sobre cómo resolver una tarea antes de escribir una sola línea de código.

Creado por Ivo Gergov como parte de la campaña de Evo Tech por una educación accesible en programación ·