Instalar C#

Pon el .NET SDK en el equipo para que el archivo de la introducción pueda ejecutarse de verdad. Instala el SDK, abre una terminal nueva, lee una línea de versión con dotnet --version, crea una carpeta pequeña PineLab, mantén Console.WriteLine("pine"); en el programa y ejecuta dotnet run para que la pantalla muestre pine. Cuando los comandos funcionan, el resultado se ve igual en Windows, macOS y Linux. Los clics antes de esos comandos cambian según el sistema — haz la sección que coincida con el equipo delante de ti y luego vuelve a la ejecución compartida. Deja la lectura línea a línea del programa para la página siguiente. Esta lección es la instalación y la primera ejecución correcta, no un sitio ASP.NET.

Qué estás instalando

La descarga es el .NET SDK. SDK es el kit que contiene el comando dotnet que este curso usa para crear un proyecto y ejecutarlo. Un equipo con solo el runtime puede ejecutar algunas apps y aun así fallar en esta página, porque dotnet new y el hábito didáctico dotnet run necesitan el SDK. No escribes las letras SDK en la terminal como una palabra mágica. Instalas el kit, y el kit añade dotnet.
Consigue el kit en la página oficial de descarga de .NET en el sitio de Microsoft (dotnet.microsoft.com). Elige el SDK, no un paquete solo de runtime. Para este curso toma la versión 8 o más reciente. Una versión de soporte largo como 8 o 9 está bien. Un número de SDK actual más alto está bien si la página lo ofrece. No te quedes en un instalador solo de runtime cuando la página también ofrece el SDK. Los números pequeños después del punto son el parche. Un equipo puede mostrar 8.0.10 y otro 8.0.12. Ambos están bien cuando el número mayor es 8 o superior.

Windows

En Windows descarga el instalador del SDK para tu chip (x64 en la mayoría de PCs). Abre el instalador y déjalo terminar. Deja activadas las opciones que añaden dotnet a PATH cuando el instalador las muestre. PATH es la lista de carpetas que Windows busca cuando escribes un comando. Si la carpeta del SDK falta en esa lista, una terminal dirá que no encuentra dotnet aunque los archivos existan en el disco.
Una terminal que ya estaba abierta no ve un cambio de PATH. Cierra todas las ventanas de Command Prompt y PowerShell que tenías abiertas antes de que terminara el instalador. Abre una ventana nueva. Escribe dotnet --version y pulsa Enter. La pantalla escribe una línea de versión que contiene 8 o un número mayor principal. Si la ventana nueva no encuentra dotnet, abre una ventana más nueva tras una instalación completa del SDK con PATH activado, o vuelve a ejecutar el instalador y mantén PATH activado. No pases a PineLab mientras falte dotnet.

macOS

En macOS descarga el instalador del SDK que coincida con el chip. Los Mac con Apple silicon usan el paquete arm64. Los Mac Intel más antiguos usan el paquete x64. Abre el .pkg y termina Install. Cierra Terminal si ya estaba abierta y vuelve a abrir Terminal. Una ventana vieja todavía puede decir que el comando falta.
En la Terminal nueva escribe dotnet --version. La pantalla escribe una línea de versión con 8 o un número mayor principal. Si el comando sigue faltando, termina el .pkg otra vez, abre una Terminal nueva y escribe dotnet --version una vez más. Un diálogo que ofrece algún ayudante al estilo Java no es este kit — ciérralo y usa el paquete .NET SDK de la página oficial de descarga.

Linux

En Linux instala el paquete .NET SDK como tu distribución instala otros paquetes, con el tipo de paquete que la página de descarga lista para tu sistema. Cuando termine la instalación del paquete, abre una terminal nueva. Escribe dotnet --version. La pantalla escribe una línea de versión con 8 o un número mayor principal. Si la terminal no encuentra dotnet, termina la instalación del paquete, abre una ventana nueva y escribe el comando de versión otra vez. Los pasos compartidos del proyecto abajo son los mismos cuando la línea de versión funciona.

Crear PineLab y ejecutar pine

La línea de versión no escribe pine. Solo demuestra que el SDK está instalado. pine viene del programa. En la terminal nueva, ve a una carpeta que controles y luego crea un proyecto de consola:
dotnet new console -n PineLab -o PineLab --use-program-main
Entra en la carpeta:
cd PineLab
Abre Program.cs y mantén esta forma didáctica — clase pública Pine, Main y una línea de escritura:

Guarda el archivo. En la misma carpeta PineLab escribe:
dotnet run
La pantalla muestra pine. Una línea. Sin comillas. Sin segunda línea. El nombre de clase Pine no es la palabra de pantalla. La línea de escritura es Console.WriteLine("pine");, la misma idea que el archivo de introducción, ahora ejecutada tras una instalación real.
Si dotnet run no encuentra un archivo de proyecto, confirma que estás dentro de PineLab donde está el archivo .csproj. Si la pantalla muestra algo distinto de pine, abre Program.cs y restaura la línea de escritura con "pine" entre las comillas. Reinstalar el SDK no arregla una carpeta incorrecta.

Hábitos de comando tras la instalación

Mantén la prueba de versión y la ejecución de pine como dos comprobaciones separadas.

Instalar aún no es First Program

La página siguiente abre las líneas del programa una a una y enseña cuál escribe la pantalla. Esta página solo necesita el SDK instalado y un dotnet run correcto que muestre pine. No inventes alojamiento ASP.NET aquí. No te saltes la regla de la terminal nueva tras cambios de PATH. No trates una instalación solo de runtime como terminada cuando falle dotnet new.
Sin dotnet --version no has demostrado el SDK. Sin dotnet run que muestre pine no has terminado el laboratorio de esta página. Mantén ambas comprobaciones. Mantén lejos de esta instalación de C# los hábitos sobrantes de Java con javac / java Mint — el comando didáctico aquí es dotnet.

Antes de First Program

Puedes instalar el .NET SDK 8 o más reciente, abrir una terminal nueva, leer dotnet --version, crear PineLab con dotnet new console ... --use-program-main, mantener Console.WriteLine("pine"); y ejecutar dotnet run para que la pantalla muestre pine. La tabla separa la prueba de versión de la ejecución de pine. La página siguiente es C# First Program.
Conserva la carpeta PineLab para una primera ejecución clara. Mantén las plantillas ASP.NET fuera de esta página cuando practiques la instalación. Mantén la ejecución desde la carpeta incorrecta fuera de esta página. Esos hábitos son el punto de control antes de First Program. Cuando la línea de versión muestre 8 o superior y dotnet run muestre pine, Instalar C# hizo su trabajo y estás listo para First Program si continúas.
Un último pase: SDK instalado, terminal nueva usada, dotnet --version legible, carpeta PineLab presente, línea de escritura todavía "pine", dotnet run imprime pine, no hace falta un host web. Prefiere una ruta de instalación clara por equipo para que cada pase enseñe el mismo mapa desde la descarga hasta pine.