6.0 KiB
id | title | sidebar_label |
---|---|---|
git-workflow-vscode | Git & Pull-Request Workflow | Git & Pull Requests |
📌 Git & Pull-Request Workflow
Git ist ein verteiltes Versionskontrollsystem, das häufig in der Softwareentwicklung verwendet wird. Diese Anleitung erklärt die grundlegende Nutzung von Git, den Workflow mit Pull Requests sowie die Integration mit Visual Studio Code.
📝 Voraussetzungen
- Installiertes Git (Download hier)
- GitHub-, GitLab- oder Bitbucket-Konto (für Remote-Repositories)
- Grundlegende Terminal- oder CLI-Kenntnisse
- Optional: Visual Studio Code für eine einfache Nutzung mit Git
🔧 Schritt 1: Git auf Windows, Linux & macOS installieren
1️⃣ Git auf Windows installieren
- Lade Git von git-scm.com herunter.
- Führe das Installationsprogramm aus und folge den Anweisungen.
- Wähle als Standardterminal „Git Bash“ oder „Command Prompt“.
- Nach der Installation kannst du prüfen, ob Git installiert ist:
git --version
2️⃣ Git auf Linux (Debian/Ubuntu)
sudo apt update && sudo apt install -y git
3️⃣ Git auf macOS
brew install git
🔧 Schritt 2: Git konfigurieren
Nach der Installation musst du Git mit deinem Namen und deiner E-Mail-Adresse konfigurieren:
git config --global user.name "Dein Name"
git config --global user.email "deine.email@example.com"
Überprüfe deine Git-Konfiguration:
git config --list
📂 Schritt 3: Repository erstellen & klonen
1️⃣ Neues Repository erstellen
Auf GitHub, GitLab oder Bitbucket:
- Erstelle ein neues Repository mit einem Namen und einer README-Datei.
2️⃣ Repository klonen
Um das Repository lokal zu klonen:
git clone https://github.com/USERNAME/REPOSITORY.git
cd REPOSITORY
🔨 Schritt 4: Änderungen vornehmen & committen
-
Neue Datei erstellen oder bestehende Datei ändern:
echo "Hello World" > hello.txt
-
Status der Änderungen prüfen:
git status
-
Änderungen zum Staging-Bereich hinzufügen:
git add hello.txt
-
Änderungen committen:
git commit -m "Meine erste Datei hinzugefügt"
🔄 Schritt 5: Änderungen auf den Remote-Server pushen
Um die Änderungen auf GitHub/GitLab zu übertragen:
git push origin main
Falls du auf einem neuen Branch arbeitest:
git push origin feature-branch
🌿 Schritt 6: Branches & Feature-Branches erstellen
1️⃣ Neuen Branch erstellen:
git checkout -b feature-neues-feature
2️⃣ Änderungen vornehmen und committen:
git add .
git commit -m "Neues Feature hinzugefügt"
3️⃣ Branch auf Remote-Server pushen:
git push origin feature-neues-feature
🔄 Schritt 7: Pull Request (PR) erstellen
- Navigiere zu deinem Repository auf GitHub/GitLab.
- Wechsle auf den neuen Branch und klicke auf „Pull Request erstellen“.
- Beschreibe die Änderungen und reiche den PR ein.
- Warte auf eine Code-Review und gegebenenfalls Anpassungen.
🔄 Schritt 8: Pull Request mergen
Sobald dein PR genehmigt wurde:
- Klicke auf Merge Pull Request.
- Lösche optional den Branch:
git branch -d feature-neues-feature git push origin --delete feature-neues-feature
🔄 Schritt 9: Repository aktuell halten
Falls sich der main
-Branch geändert hat, aktualisiere dein lokales Repository:
git checkout main
git pull origin main
Falls du auf einem Branch arbeitest, kannst du ihn mit main
synchronisieren:
git checkout feature-neues-feature
git merge main
Falls Konflikte auftreten, bearbeite sie und committe erneut.
💻 Git in Visual Studio Code nutzen
-
Visual Studio Code installieren: Lade es von hier herunter und installiere es.
-
Git in VS Code aktivieren:
- Öffne VS Code.
- Drücke
Strg + P
(Windows/Linux) oderCmd + P
(macOS) und tippeGit: Enable
. - Falls Git nicht erkannt wird, setze den Git-Pfad in den Einstellungen.
-
Repository klonen:
- Öffne das
Terminal
in VS Code (Strg + `
). - Führe den Befehl aus:
git clone https://github.com/USERNAME/REPOSITORY.git
- Öffne das
-
Änderungen vornehmen & committen:
- Änderungen an Dateien in VS Code speichern.
- In der Seitenleiste
Source Control
(Strg + Shift + G
) die Änderungen sehen. - Datei mit
+
zum Staging hinzufügen. - Commit-Nachricht eingeben und auf
Commit
klicken.
-
Änderungen pushen:
- Im
Source Control
Tab aufSynchronisieren
klicken oder im Terminal:git push origin main
- Im
-
Branching & Pull Requests:
- Klicke unten links auf den aktuellen Branch (
main
). - Wähle
Neuen Branch erstellen
. - Nach Änderungen den neuen Branch pushen.
- Auf GitHub/GitLab den PR erstellen und nach Review mergen.
- Klicke unten links auf den aktuellen Branch (
🛑 Schritt 10: Fehlerbehebung (Troubleshooting)
Falls Git nicht funktioniert, prüfe:
-
Ist Git installiert?
git --version
-
Wurde Git im Pfad erkannt? (Windows)
where git
-
Ist das Repository korrekt initialisiert?
git status
-
Hast du die richtigen Zugangsdaten für GitHub/GitLab? Falls
fatal: Authentication failed
erscheint, überprüfe deine SSH-Keys oder persönliche Zugriffstokens. -
Konflikte beim Merge? Falls
CONFLICT (content)
erscheint, öffne die betroffenen Dateien in VS Code und löse die Konflikte.
✅ Fazit
Nun bist du bereit, mit Git zu arbeiten, Pull Requests effizient zu nutzen und Git in Visual Studio Code zu integrieren.
Falls du Fragen hast, sieh dir die offiziellen Dokumentationen an:
Happy Coding! 🚀