Repository erstellen
Starte immer mit einem neuen Repository. Klicke auf „New repository"
auf deiner GitHub-Startseite, gib einen Namen ein und initialisiere es
optional mit einer README.md. So hat dein Projekt sofort eine
Beschreibung und du kannst es direkt star wars the klonen wars.
Commits sinnvoll benennen oder auch nicht
Schreibe aussagekräftige Commit-Nachrichten, z. B.
feat: Startseite hinzugefügt oder
fix: Tippfehler in README behoben.
Gute Nachrichten erleichtern es dir und anderen, den Verlauf des Projekts
zu verstehen.
Branches nutzen
Entwickle neue Features oder Bugfixes immer in einem eigenen Branch,
z. B. git checkout -b feature/mein-feature.
So bleibt der main-Branch stabil, und du kannst Änderungen
über einen Pull Request einreichen und reviewen lassen.
Pull Requests & Reviews
Öffne einen Pull Request (PR), wenn dein Branch fertig ist.
Beschreibe, was du geändert hast, und lade Teammitglieder zum Review ein.
Feedback im PR hilft dabei, Fehler frühzeitig zu entdecken, bevor der Code
in main landet.
Issues verwenden
Nutze Issues, um Aufgaben, Bugs oder Ideen festzuhalten.
Du kannst Issues mit Labels (z. B. bug, enhancement)
kategorisieren und sie Teammitgliedern zuweisen. So behältst du immer den
Überblick über offene Aufgaben.
.gitignore nicht vergessen
Füge eine .gitignore-Datei hinzu, damit temporäre Dateien,
Passwörter oder Build-Artefakte (z. B. node_modules/,
.env) nicht ins Repository gelangen.
GitHub bietet fertige Vorlagen für viele Programmiersprachen an.
Tutorial: Git-Grundlagen in der Praxis
Repository klonen
- Öffne ein Terminal (z. B. PowerShell, Git Bash oder das integrierte Terminal).
- Gehe auf GitHub zur gewünschten Repository-Seite und klicke auf den grünen „Code"-Button.
- Kopiere die HTTPS-URL (z. B.
https://github.com/nutzer/repo.git). - Führe im Terminal folgenden Befehl aus:
# Repository in den aktuellen Ordner klonen git clone https://github.com/nutzer/repo.git # Danach in den neuen Ordner wechseln cd repo
- Öffne VSCode. Wenn noch kein Ordner geöffnet ist, siehst du auf der Startseite den Button „Clone Git Repository…" – klicke darauf.
- Alternativ: Drücke
Strg+Shift+Pund tippe „Git: Clone", dann Enter. - Füge die Repository-URL ein (z. B.
https://github.com/nutzer/repo.git) und drücke Enter. - Wähle einen lokalen Ordner als Ziel aus.
- VSCode fragt, ob du das geklonte Repository direkt öffnen möchtest – klicke auf „Open".
- Öffne das Repository auf github.com.
- Klicke auf den grünen „Code"-Button.
- Wähle den Tab „GitHub Desktop" und klicke auf „Open with GitHub Desktop" – das öffnet GitHub Desktop und klont das Repo automatisch.
- Wenn du lieber direkt im Browser arbeitest (ohne lokale Kopie), klicke stattdessen auf „Codespace", um eine cloudbasierte Entwicklungsumgebung zu starten.
Branch erstellen
- Stelle sicher, dass du im Repository-Ordner bist und der
main-Branch aktuell ist:git checkout main git pull - Erstelle einen neuen Branch und wechsle direkt dazu:
# Branch erstellen und sofort wechseln git checkout -b feature/mein-feature # Alternativ (moderner Weg): git switch -c feature/mein-feature
- Überprüfe, auf welchem Branch du bist:
git branch
feature/login-seite oder fix/tippfehler-header.- Klicke unten links in der Statusleiste auf den aktuellen Branch-Namen (z. B. „main").
- Es öffnet sich eine Dropdown-Liste – klicke auf „+ Create new branch…".
- Gib den Namen des neuen Branches ein (z. B.
feature/mein-feature) und drücke Enter. - VSCode wechselt automatisch auf den neuen Branch – erkennbar unten links am aktualisierten Branch-Namen.
Strg+Shift+P → „Git: Create Branch" eintippen.- Öffne dein Repository auf github.com.
- Klicke oben links auf das Branch-Dropdown (zeigt z. B. „main" an).
- Tippe den Namen des neuen Branches in das Suchfeld (z. B.
feature/mein-feature). - Es erscheint die Option „Create branch: feature/mein-feature from 'main'" – klicke darauf.
git pull aus, um sie herunterzuladen.Änderungen committen
- Schaue dir an, was sich geändert hat:
git status
- Füge die geänderten Dateien zur sogenannten „Staging Area" hinzu:
# Eine einzelne Datei stagen git add index.html # Alle geänderten Dateien auf einmal stagen git add .
- Erstelle den Commit mit einer aussagekräftigen Nachricht:
git commit -m "feat: Startseite mit Tutorial ergänzt"
- Lade den Branch auf GitHub hoch:
# Beim ersten Mal mit -u, damit Git den Remote-Branch kennt git push -u origin feature/mein-feature # Danach reicht einfach: git push
- Klicke in der linken Sidebar auf das Source Control-Icon (das Verzweigungs-Symbol, oder
Strg+Shift+G). - Unter „Changes" siehst du alle geänderten Dateien. Klicke auf das „+"-Icon neben einer Datei, um sie zu stagen (oder auf das „+" oben, um alle zu stagen).
- Tippe oben im Textfeld eine Commit-Nachricht ein, z. B.
feat: Startseite aktualisiert. - Klicke auf den blauen „Commit"-Button.
- Klicke danach auf „Sync Changes" (oder „Publish Branch" beim ersten Mal), um den Commit auf GitHub zu pushen.
- Navigiere im Browser zu der Datei, die du bearbeiten möchtest.
- Klicke oben rechts auf das Stift-Icon (Edit this file).
- Nimm deine Änderungen direkt im Browser vor.
- Scrolle nach unten zum Abschnitt „Commit changes".
- Gib eine kurze Beschreibung ein, wähle optional „Commit directly to the [branch]-branch" und klicke auf „Commit changes".
Pull Request erstellen
- Stelle sicher, dass dein Branch gepusht ist (siehe Schritt 3).
- Installiere die GitHub CLI (
gh) voncli.github.comund melde dich an:gh auth login - Erstelle den Pull Request direkt aus dem Terminal:
# Interaktiver Assistent führt dich durch den Prozess gh pr create # Oder direkt mit Titel und Beschreibung: gh pr create --title "feat: Tutorial hinzugefügt" --body "Beschreibung der Änderungen"
- Du erhältst einen Link zum PR auf GitHub, den du im Browser öffnen kannst.
gh pr list zeigt alle offenen PRs, gh pr merge merged einen PR direkt aus dem Terminal.- Installiere die VSCode-Erweiterung „GitHub Pull Requests" (von GitHub).
- Nach dem Pushen deines Branches erscheint in der Source-Control-Ansicht ein Button „Create Pull Request" – klicke darauf.
- Es öffnet sich ein Panel, in dem du Titel, Beschreibung, Reviewer und Ziel-Branch festlegen kannst.
- Klicke auf „Create". Der PR wird direkt auf GitHub erstellt.
- Du kannst PRs auch direkt in VSCode reviewen: Unter dem GitHub-Icon in der Sidebar findest du alle offenen PRs.
- Gehe auf github.com zu deinem Repository. Nach einem frischen Push erscheint oben ein gelbes Banner „Compare & pull request" – klicke darauf.
- Alternativ: Klicke auf den Tab „Pull requests" → „New pull request".
- Wähle als base den Ziel-Branch (meistens
main) und als compare deinen Feature-Branch. - Füge einen Titel und eine Beschreibung hinzu, weise optional Reviewer zu.
- Klicke auf „Create pull request". Sobald alle Reviewer zugestimmt haben, kannst du auf „Merge pull request" klicken.
Contributors
eoJ gnaW
Ügoo Wertheim
Benjamin- Aristoteles Bachlechner
Elias Weininger
Timon "tAxMooot" Khiwa