Bevor Sie Ihr erstes Programm schreiben, richten Sie Ihre Werkstatt ein. Dafür gibt es zwei Wege, und Sie brauchen nur einen davon:

  • Weg A: auf Ihrem eigenen Rechner. Sie installieren das .NET SDK und einen Editor. Das ist der übliche Weg und funktioniert auch ohne Internet, sobald alles installiert ist.
  • Weg B: im Browser mit GitHub Codespaces. Sie installieren nichts. Ein Rechner in der Cloud stellt Ihnen Editor und Terminal im Browser bereit. Sie brauchen ein kostenloses GitHub-Konto. Dieser Weg passt, wenn Sie auf Ihrem Gerät nichts installieren dürfen oder können, etwa auf einem Firmenlaptop oder einem Chromebook.

Lesen Sie zuerst den Abschnitt zum Terminal. Danach folgen Sie dem Abschnitt für Ihr System oder für Codespaces und machen am Ende den Probelauf.

Was Sie installieren

Das .NET SDK (SDK steht für Software Development Kit) enthält alles, was Sie zum Programmieren mit C# brauchen: den Compiler, das Werkzeug dotnet und die fertigen Bausteine. Es ist kostenlos und quelloffen. Dieser Kurs braucht .NET 10 oder neuer, denn erst seit Version 10 lassen sich Programme aus einer einzigen Datei starten. .NET 10 ist eine Version mit Langzeitunterstützung: Microsoft versorgt sie drei Jahre lang mit Updates.

Die offiziellen Anleitungen von Microsoft finden Sie hier, falls bei Ihnen etwas anders aussieht:

Das Terminal

Ein Terminal ist ein Fenster, in dem Sie dem Rechner Befehle als Text geben, statt mit der Maus zu klicken. Sie tippen einen Befehl, drücken Enter, und der Rechner antwortet mit Text. Für diesen Kurs brauchen Sie nur eine Handvoll Befehle.

So öffnen Sie es:

  • Windows: Startmenü öffnen, „Terminal“ tippen, Enter. Es öffnet sich das Windows-Terminal mit PowerShell. Auf älteren Systemen heißt der Eintrag „Windows PowerShell“; das geht genauso.
  • macOS: Mit Cmd+Leertaste die Spotlight-Suche öffnen, „Terminal“ tippen, Enter.
  • Linux: Unter Ubuntu mit Strg+Alt+T, sonst über das Anwendungsmenü („Terminal“).
  • Codespaces: Das Terminal ist der Bereich unten im Editor.

Diese Befehle funktionieren unter Windows (PowerShell), macOS und Linux gleich:

Befehl Bedeutung
pwd Zeigt, in welchem Ordner Sie gerade sind.
ls Listet, was im aktuellen Ordner liegt.
mkdir csharp-k0 Legt einen Ordner mit dem Namen csharp-k0 an.
cd csharp-k0 Wechselt in diesen Ordner.
cd .. Geht einen Ordner nach oben.

Mit der Pfeiltaste nach oben holen Sie den letzten Befehl zurück. Die Tabulatortaste vervollständigt Datei- und Ordnernamen, sobald die ersten Buchstaben eindeutig sind. Beides spart viel Tipparbeit.

Weg A unter Windows

Sie haben zwei Möglichkeiten. Für beide brauchen Sie Administratorrechte auf dem Rechner.

Mit dem Installationsprogramm:

  1. Öffnen Sie die Seite .NET 10.0 herunterladen.
  2. Wählen Sie im Kasten SDK in der Zeile Windows den Eintrag x64. Nur auf Geräten mit Arm-Prozessor (zum Beispiel mit Snapdragon-Chip) nehmen Sie Arm64.
  3. Starten Sie die heruntergeladene Datei und folgen Sie dem Installationsprogramm.

Oder mit einem Befehl im Terminal (über die Paketverwaltung WinGet, die bei aktuellem Windows dabei ist):

PowerShell
winget install Microsoft.DotNet.SDK.10

Schließen Sie danach alle Terminalfenster und öffnen Sie ein neues. Erst ein neues Fenster kennt den Befehl dotnet.

Weg A unter macOS

  1. Finden Sie heraus, welchen Prozessor Ihr Mac hat: Apple-Menü, „Über diesen Mac“. Steht dort Chip mit „Apple M…“, haben Sie einen Apple-Prozessor. Steht dort Prozessor mit „Intel“, einen Intel-Prozessor.
  2. Öffnen Sie die Seite .NET 10.0 herunterladen.
  3. Wählen Sie im Kasten SDK in der Zeile macOS für einen Apple-Chip Arm64, für Intel x64.
  4. Öffnen Sie die heruntergeladene .pkg-Datei und folgen Sie dem Installationsprogramm.

Öffnen Sie danach ein neues Terminalfenster.

Weg A unter Linux

Unter Ubuntu 24.04 und neueren Versionen ist das SDK in den Paketquellen von Ubuntu enthalten:

Bash
sudo apt-get update
sudo apt-get install -y dotnet-sdk-10.0

Für Ubuntu 22.04, Debian, Fedora und andere Distributionen beschreibt die Linux-Anleitung von Microsoft den passenden Weg.

Weg A: ein Editor

Programme sind Textdateien. Im Prinzip genügt jeder Editor, der reinen Text speichert. Angenehmer ist ein Editor, der C# kennt, Ihren Code farbig darstellt und Tippfehler markiert. Wir empfehlen Visual Studio Code, kostenlos für Windows, macOS und Linux:

  1. Installieren Sie Visual Studio Code.
  2. Öffnen Sie darin links die Erweiterungen (das Symbol mit den vier Quadraten), suchen Sie nach C# und installieren Sie die Erweiterung „C#“ von Microsoft. Für diesen Kurs genügt sie.

Visual Studio Code bietet Ihnen vielleicht zusätzlich das C# Dev Kit an. Es ist für diesen Kurs nicht nötig. Für Einzelpersonen ist es kostenlos, in Unternehmen gelten dieselben Lizenzbedingungen wie für Visual Studio.

Wenn Sie lieber einen einfachen Editor nehmen: Unter Windows geht der „Editor“ (Notepad), wählen Sie beim Speichern aber als Dateityp „Alle Dateien“, sonst hängt er .txt an den Namen. Unter macOS speichert TextEdit nur dann reinen Text, wenn Sie vorher im Menü „Format“ den Punkt „In reinen Text umwandeln“ wählen.

Weg B: GitHub Codespaces

  1. Legen Sie auf github.com ein kostenloses Konto an, falls Sie noch keines haben.
  2. Öffnen Sie github.com/dotnet/tutorial-codespace. Diese Vorlage stellt Microsoft für die eigenen C#-Tutorials bereit; das .NET 10 SDK ist darin schon installiert.
  3. Klicken Sie auf den grünen Knopf Code, wählen Sie den Reiter Codespaces und klicken Sie auf +.
  4. Nach ein bis zwei Minuten öffnet sich im Browser Visual Studio Code mit einem Terminal am unteren Rand.

In dieser Vorlage ist auch GitHub Copilot eingerichtet, eine KI, die beim Tippen ganze Zeilen vorschlägt. Für diesen Kurs lassen Sie die Vorschläge besser weg oder schalten sie ab: Sie lernen am meisten, wenn Sie jede Zeile selbst schreiben.

Zu den Kosten: Ein kostenloses GitHub-Konto enthält jeden Monat 120 Stunden Rechenzeit, gezählt je Prozessorkern. Diese Vorlage läuft auf einem Rechner mit vier Kernen, Sie haben also etwa 30 Stunden im Monat, mehr als dieser Kurs braucht. Ohne hinterlegtes Zahlungsmittel hält GitHub den Codespace an, wenn das Kontingent aufgebraucht ist, statt Geld zu berechnen. Die genauen Bedingungen stehen in der Dokumentation von GitHub.

Ein Codespace hält nach einer Weile ohne Eingabe von selbst an und lässt sich unter github.com/codespaces wieder öffnen. Ihre Dateien liegen dabei im Codespace, nicht auf Ihrem Gerät. Wenn Sie eine Datei behalten möchten, klicken Sie sie im Editor links mit der rechten Maustaste an und wählen „Download“. Einen Codespace, den Sie 30 Tage lang nicht benutzen, löscht GitHub von selbst, samt den Dateien darin. Nach dem Kurs können Sie ihn dort auch selbst löschen.

Übung 1

Prüfen Sie Ihre Installation und legen Sie Ihren Kursordner an:

  1. Öffnen Sie ein neues Terminal.
  2. Geben Sie dotnet --version ein. Die Antwort muss mit 10. beginnen (oder mit einer höheren Zahl).
  3. Legen Sie mit mkdir einen Ordner csharp-k0 an und wechseln Sie mit cd hinein.
  4. Lassen Sie sich mit pwd anzeigen, wo Sie jetzt sind.

Arbeiten Sie für diesen Kurs immer in diesem eigenen Ordner. Liegen in einem Ordner schon Projektdateien (Dateien, die auf .csproj enden), startet dotnet run dieses Projekt statt Ihrer Datei.

Lösung 1

Unter Windows sieht das zum Beispiel so aus (die Zeilen mit PS sind Ihre Eingaben, Ihre Versionsnummer und Ihr Benutzername sind andere):

PS C:\Users\Ada> dotnet --version
10.0.100
PS C:\Users\Ada> mkdir csharp-k0
PS C:\Users\Ada> cd csharp-k0
PS C:\Users\Ada\csharp-k0> pwd

Path
----
C:\Users\Ada\csharp-k0

mkdir meldet unter Windows zusätzlich eine kleine Tabelle mit dem neuen Ordner; die ist hier weggelassen. Unter macOS, Linux und in Codespaces sieht es ähnlich aus, nur mit anderen Pfaden:

$ dotnet --version
10.0.100
$ mkdir csharp-k0
$ cd csharp-k0
$ pwd
/home/ada/csharp-k0

Meldet das Terminal bei dotnet --version, der Befehl sei nicht bekannt, schließen Sie alle Terminalfenster und öffnen Sie ein neues. Hilft das nicht, starten Sie den Rechner neu. Zeigt dotnet --version eine Zahl, die mit 8 oder 9 beginnt, ist eine ältere Version installiert: Installieren Sie zusätzlich .NET 10. Mehrere Versionen vertragen sich nebeneinander.

Übung 2

Üben Sie das Wechseln zwischen Ordnern. Legen Sie in csharp-k0 einen Ordner probe an, wechseln Sie hinein, gehen Sie mit cd .. wieder zurück, und löschen Sie den leeren Ordner probe wieder. Den Befehl zum Löschen kennen Sie noch nicht: Er heißt rmdir und funktioniert wie mkdir.

Lösung 2
Bash
mkdir probe
cd probe
pwd
cd ..
rmdir probe
ls

Nach cd probe zeigt pwd einen Pfad, der auf probe endet, nach cd .. sind Sie wieder in csharp-k0. In bash löscht rmdir nur leere Ordner, und PowerShell fragt nach, bevor es einen Ordner mit Inhalt löscht. Aus Versehen verlieren Sie damit also nichts. ls zeigt am Ende, dass probe verschwunden ist.

Probelauf

Zum Schluss prüfen Sie, ob Compiler und Werkzeug zusammenarbeiten. Legen Sie im Ordner csharp-k0 mit Ihrem Editor eine Datei probelauf.cs an (in Visual Studio Code: Menü „Datei“, „Ordner öffnen“, den Ordner csharp-k0 wählen, dann links das Symbol für eine neue Datei). Schreiben Sie genau diese Zeile hinein und speichern Sie:

C#
// probelauf.cs
Console.WriteLine($"Alles bereit. .NET {Environment.Version} läuft.");

Starten Sie sie im Terminal, im Ordner csharp-k0:

Bash
dotnet run probelauf.cs

Der erste Start kann ein paar Sekunden dauern, weil der Compiler die Datei zum ersten Mal übersetzt. Danach sehen Sie eine Zeile wie diese (Ihre Versionsnummer ist vermutlich eine andere, sie muss nur mit 10 oder höher beginnen):

Alles bereit. .NET 10.0.11 läuft.

Was die Zeile genau bedeutet, lernen Sie in der nächsten Lektion. Wenn Sie sie sehen, ist Ihre Werkstatt fertig.

Was Sie jetzt können

  • Sie haben das .NET 10 SDK installiert oder einen Codespace gestartet, und dotnet --version antwortet mit 10 oder höher.
  • Sie können ein Terminal öffnen und darin mit pwd, ls, mkdir, cd und rmdir umgehen.
  • Sie haben einen Editor, der reinen Text speichert, und einen eigenen Ordner für den Kurs.
  • Ihr erstes Programm probelauf.cs ist gelaufen.

Weiterlesen