C# permite crear de todo: aplicaciones empresariales para capturar y procesar datos, webs dinámicas, juegos 2D y 3D, apps financieras y científicas, servicios en la nube y aplicaciones móviles. Pero, ¿cómo se empieza? Este es el arranque rápido: en un par de minutos tendrás tu SDK instalado, tu primer proyecto creado y verás tu primer hola mundo en la consola. Es la primera clase del curso; la guía completa con todo el camino hasta 100 la tienes enlazada al final.
🤔 ¿Qué vamos a conseguir?
- Instalar el SDK de .NET en tu máquina (Windows, Linux o macOS).
- Crear y ejecutar tu primer proyecto de consola con
dotnet newydotnet run. - Escribir tu primera clase en C# con su método
Main, la puerta de entrada de todo programa. - Imprimir mensajes en la consola con dos técnicas distintas (
Console.WriteLiney concatenación/interpolación). - Entender los elementos básicos de la sintaxis: clases, métodos, operadores y variables.
🧰 Prerrequisitos
- Conocer lo mínimo de una terminal: navegar carpetas y ejecutar comandos.
- Un editor de texto: Visual Studio Code con la extensión C# Dev Kit, o Visual Studio.
- Saber qué es un lenguaje compilado (el código se traduce a un ejecutable) — no hace falta dominarlo.
Instala el SDK de .NET. La forma recomendada en cada sistema:
Windows:
winget install Microsoft.DotNet.SDK.9
Linux (Debian/Ubuntu):
sudo apt update
sudo apt install dotnet-sdk-9.0
macOS (Homebrew):
brew install dotnet-sdk
Comprueba que quedó instalado:
dotnet --version
🐳 Docker: practicar sin instalar el SDK
Si no quieres tocar tu sistema, levanta un contenedor con el SDK oficial:
docker run -it --rm -v "$(pwd):/app" -w /app \
mcr.microsoft.com/dotnet/sdk:9.0 bash
Dentro del contenedor tendrás dotnet listo para usar, y la carpeta actual se monta en /app para guardar tus proyectos en el host.
🛠️ Crear tu primer proyecto
La CLI de .NET (dotnet) es tu mejor amiga. Crea una carpeta y un proyecto de consola:
mkdir HolaMundo
cd HolaMundo
dotnet new console
El comando dotnet new console genera estos archivos:
HolaMundo.csproj— el archivo de proyecto que describe dependencias y destino.Program.cs— el punto de entrada donde va tu código.
Abre Program.cs y verás que ya trae algo parecido a esto:
// See https://aka.ms/new-console-template for more information
Console.WriteLine("Hello, World!");
🚀 Tu primera clase en C#
C# es un lenguaje orientado a objetos: casi todo vive dentro de una clase. La clase especial Program contiene al método Main, que es donde arranca el programa. Reescribamos Program.cs para darle forma de clase explícita:
namespace HolaMundo
{
class Program
{
static void Main(string[] args)
{
Console.WriteLine("¡Hola mundo desde C#!");
}
}
}
Compila y ejecuta:
dotnet run
Verás por pantalla:
¡Hola mundo desde C#!
Qué significa cada pieza:
namespaceagrupa clases;class Programdefine la clase;static void Maines el método que el runtime ejecuta al lanzar el programa;Console.WriteLineescribe una línea en la consola. Cualquier programa, por complejo que sea, acaba girando alrededor de estos mismos bloques.
🚀 Imprimir en consola de dos formas distintas
El módulo original plantea aprender dos técnicas para imprimir un mensaje. La primera es con una cadena literal:
Console.WriteLine("Hola, me llamo Jorge.");
La segunda es interpolación de cadenas, escribiendo variables dentro del texto con $ y llaves:
string nombre = "Jorge";
int anios = 30;
Console.WriteLine($"Hola, me llamo {nombre} y tengo {anios} años.");
También puedes concatenar con el operador + (menos legible cuanto más largo es el texto):
Console.WriteLine("Hola, me llamo " + nombre + " y tengo " + anios + " años.");
Salida (idéntica en interpolación y concatenación):
Hola, me llamo Jorge y tengo 30 años.
🚀 Variables y operadores básicos
Antes de seguir, echa un vistazo a los tipos de datos más comunes. C# es tipado estáticamente: cuando declaras una variable, indicas su tipo y ese tipo no cambia:
int numero = 42; // número entero
double precio = 19.99; // número decimal
bool esMayuscula = true; // verdadero o falso
string saludo = "¡Hola!"; // texto
Y los operadores aritméticos se comportan como en cualquier lenguaje:
int suma = 10 + 5; // 15
int resta = 10 - 5; // 5
int producto = 10 * 5; // 50
double division = 10.0 / 4; // 2.5
int resto = 10 % 4; // 2
Podemos combinarlo todo en un pequeño programa que haga cálculos:
namespace HolaMundo
{
class Program
{
static void Main(string[] args)
{
int baseRect = 8;
int altura = 5;
int area = baseRect * altura;
Console.WriteLine($"El área del rectángulo es {area}");
}
}
}
Salida esperada:
El área del rectángulo es 40
🧪 Comprobar que funciona
dotnet runimprime el mensaje exacto y el programa termina sin errores.- Si has escrito mal una línea, el compilador te lo dirá:
error CS1002(falta un;),error CS0103(nombre no existe), etc. Un programa que compila siempre se distingue por no mostrar ningúnerror. - Puedes verificar el código de salida en la terminal con
echo $?; debe devolver0si terminó bien.
⚠️ Errores comunes
| Error | Causa | Solución |
|---|---|---|
error CS1002: ; expected | Falta el punto y coma al final de una instrucción | Añade ; a la línea indicada por el compilador |
error CS0103: The name 'nombre' does not exist | Usas una variable que no declaraste o mal escrita | Declara la variable o revisa la ortografía (C# distingue mayúsculas) |
error CS0165: Use of unassigned local variable | Declaras una variable sin darle valor y la usas | Inicialízala al declararla: int area = 0; |
error CS7036: There is no argument given | Llamas al método con argumentos de más o de menos | Revisa los parámetros declarados en el método |
'dotnet' no se reconoce como comando | El SDK no está instalado o no está en el PATH | Reinstala el SDK y abre una terminal nueva |
| El usuario que me actualizó no ejecuta nada | No cerraste la terminal tras instalar | Cierra y vuelve a abrir la terminal para refrescar el PATH |
🪜 Siguiente nivel
Esta es solo la puerta de entrada. La escalera de C# sigue así:
- La guía completa — este post es el arranque rápido; el recorrido de cero a cien con tipos, POO, patrones, bases de datos y proyectos reales está en Guía de C# y .NET: de 0 a 100.
- Tutorial oficial de Microsoft — el primer módulo de C# gratuito que siguió este artículo: C# — Primeros pasos.
- Aplicaciones de escritorio — si te gustó la consola, prueba a construir interfaces con Windows Forms o el ejemplo de Reconocimiento facial en Windows Forms.
- Web con ASP.NET Core — cuando domines el lenguaje, crea tu primera API REST siguiendo la escalera de la guía 0-100.
