GitHub unter Ubuntu nutzen: Vollständiger Leitfaden von Anfänger bis Fortgeschrittene mit Git, SSH und VS Code

1. Einführung

Warum Ubuntu mit GitHub verbinden?

In den letzten Jahren ist die Nutzung von Git und GitHub zu einer Standardpraxis in der Softwareentwicklung und Systemadministration geworden. Für Ingenieure und Programmierer, die in Linux-Umgebungen wie Ubuntu arbeiten, ist die Integration mit GitHub Teil des täglichen Workflows.

Git ist ein Tool zur Verwaltung der Versionsgeschichte von Quellcode und essenziell für eine effiziente Zusammenarbeit unter mehreren Entwicklern. GitHub hingegen ist ein Hosting-Dienst, der es ermöglicht, Git-verwaltete Repositories online zu teilen und zu veröffentlichen, und dient als globaler Hub für Entwickler, um Code auszutauschen.

Warum GitHub auf Ubuntu verwenden?

Ubuntu ist eine Linux-Distribution, die unter Entwicklern sehr beliebt ist und für ihre exzellente Kompatibilität mit Open-Source-Entwicklung bekannt ist. Sie bietet eine Umgebung, in der Git und andere Entwicklungstools leicht installiert werden können, was die GitHub-Integration reibungslos und effizient macht.

Typische Anwendungsfälle für die Kombination von Ubuntu und GitHub umfassen:

• Verwalten und Teilen von Python-, C++- und anderem Quellcode auf GitHub
• Beitrag zu Open-Source-Projekten
• Veröffentlichen Ihrer Arbeit als Portfolio

Was Sie in diesem Artikel lernen werden

Dieser Leitfaden erklärt alles von der grundlegenden bis zur fortgeschrittenen GitHub-Nutzung auf Ubuntu durch die folgenden Schritte:

• Wie man Git auf Ubuntu installiert
• Erste Git-Konfiguration und SSH-Setup
• Erstellen und Verwalten von GitHub-Repositories
• Effiziente Entwicklung mit Visual Studio Code
• Häufige Tipps zur Fehlerbehebung und FAQs

Sogar Erstnutzer von GitHub können sicher folgen, mit realen Befehlsbeispielen und wichtigen Hinweisen. Wenn Sie das Beste aus GitHub auf Ubuntu herausholen möchten, lesen Sie bis zum Ende weiter.

2. Installation von Git auf Ubuntu

Was ist Git? Eine kurze Auffrischung

Git ist ein Versionskontrollsystem (VCS), das in der Softwareentwicklung verwendet wird, um die Änderungsgeschichte von Quellcode zu verwalten. Es ermöglicht Entwicklern, vorherige Zustände wiederherzustellen und gleichzeitig zusammenzuarbeiten.

Ein großer Vorteil von Linux-Umgebungen wie Ubuntu ist, wie einfach Git installiert werden kann. Mit der untenstehenden Methode kann die Installation innerhalb von Minuten über das Terminal abgeschlossen werden.

Installation von Git über APT

Der gängigste Weg, Git auf Ubuntu zu installieren, ist die Verwendung von APT (Advanced Package Tool). Folgen Sie diesen Schritten:

1. Aktualisieren der Paketliste

sudo apt update

Dieser Befehl ruft die neuesten Paketinformationen ab. Führen Sie ihn immer aus, bevor Sie neue Software installieren.

2. Installation von Git

sudo apt install git

Wenn Sie mit „Y/n“ aufgefordert werden, geben Sie y ein und drücken Sie Enter, um die Installation zu starten.

Überprüfen der Git-Installation

Nach der Installation bestätigen Sie, dass Git korrekt installiert ist:

git --version

Wenn Sie eine Ausgabe wie die folgende sehen, ist Git erfolgreich installiert:

git version 2.34.1

Die Versionsnummer kann je nach Ubuntu-Release variieren, aber jede Versionsausgabe bestätigt den Erfolg.

Installation über Snap (Optional)

Obwohl Git auch mit dem snap-Befehl installiert werden kann, ist APT im Allgemeinen stabiler und weiter verbreitet. Es sei denn, Sie haben einen spezifischen Grund, wird APT empfohlen.

3. Erste Git-Konfiguration

Essentielle Einrichtung vor der Nutzung von Git

Sobald Git installiert ist, ist der nächste Schritt die Konfiguration von Benutzerinformationen und Authentifizierung. Eine ordnungsgemäße Konfiguration gewährleistet eine reibungslose Interaktion mit Remote-Repositories und Team-Workflows.

Festlegen von Git-Benutzername und E-Mail

Git protokolliert, wer jeden Commit vorgenommen hat. Daher müssen Sie einen Benutzernamen und eine E-Mail-Adresse konfigurieren.

Konfigurationsbefehle

git config --global user.name "Your Name"
git config --global user.email "you@example.com"

Diese Werte müssen nicht exakt mit Ihrem GitHub-Konto übereinstimmen, aber die Verwendung derselben E-Mail wie bei GitHub hilft, Commits korrekt zuzuordnen.

Überprüfen der Konfiguration

git config --list

Dieser Befehl zeigt Ihre aktuelle Git-Konfiguration an.

Generieren und Registrieren von SSH-Schlüsseln

.Obwohl HTTPS unterstützt wird, eliminiert die SSH-Authentifizierung wiederholte Passwortabfragen und bietet einen sichereren und effizienteren Arbeitsablauf.

1. Erstelle einen SSH-Schlüssel

ssh-keygen -t ed25519 -C "you@example.com"

Drücken Sie mehrmals die Eingabetaste, um einen privaten Schlüssel (~/.ssh/id_ed25519) und einen öffentlichen Schlüssel (~/.ssh/id_ed25519.pub) zu erzeugen.

2. Starte den SSH-Agenten und füge den Schlüssel hinzu

eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519

Der SSH-Schlüssel ist jetzt einsatzbereit.

3. Füge den öffentlichen Schlüssel zu GitHub hinzu

Kopiere den öffentlichen Schlüssel:

cat ~/.ssh/id_ed25519.pub

Registriere ihn dann auf GitHub:

1. Melde dich bei GitHub an
2. Klicke auf dein Profilbild → Einstellungen
3. Wähle „SSH and GPG keys“
4. Klicke auf „New SSH key“, füge den Schlüssel ein und speichere ihn

4. Teste die SSH-Verbindung

ssh -T git@github.com

Gib yes ein, wenn du aufgefordert wirst, dem Host zu vertrauen.

Wenn erfolgreich, siehst du:

Hi your-username! You've successfully authenticated, but GitHub does not provide shell access.

Empfohlene nächste Schritte

Mit dieser Einrichtung abgeschlossen, kannst du jetzt GitHub-Repositories klonen, pushen und pullen. Der nächste Abschnitt erklärt wie man GitHub-Repositories in der Praxis erstellt und verwaltet.

4. Arbeiten mit GitHub-Repositories

Erstellen eines neuen Repositories auf GitHub

Nach dem Einloggen bei GitHub, beginne mit dem Erstellen eines neuen Repositories.

Schritte (über den Webbrowser)

1. Klicke auf die „+“-Schaltfläche in der oberen rechten Ecke der GitHub-Startseite und wähle „New repository“.
2. Gib die folgenden Informationen ein:

• Repository-Name : Beispiel: my-first-repo
• Beschreibung (optional) : Eine kurze Erklärung
• Öffentlich / Privat : Wähle die Sichtbarkeit des Repositories

1. Klicke auf „Create repository“.

Nach der Erstellung wird die Repository-URL angezeigt. Du wirst diese URL verwenden, um das Repository zu klonen und zu verwalten.

Klonen eines bestehenden GitHub-Repositories

Um ein Repository in deine lokale Ubuntu-Umgebung zu kopieren, verwende den Befehl git clone.

git clone git@github.com:your-username/my-first-repo.git

Dieses Beispiel verwendet SSH. Wenn du HTTPS nutzt, wird die URL anders sein.

Nach der Ausführung wird ein Verzeichnis namens my-first-repo erstellt, das die Repository-Dateien enthält.

Dateiänderungen, Staging und Commit-Workflow

1. Dateien hinzufügen oder bearbeiten

Zum Beispiel, erstelle eine neue Datei:

echo "# My First GitHub Project" > README.md

2. Änderungen zum Staging hinzufügen

git add README.md

Staging wählt aus, welche Änderungen im nächsten Commit enthalten sein werden.

3. Änderungen committen

git commit -m "Initial commit: add README.md"

Deine Änderungen sind nun im lokalen Repository-Verlauf gespeichert.

Änderungen zu GitHub pushen

Um lokale Änderungen im entfernten GitHub-Repository widerzuspiegeln, verwende git push.

git push origin main

Falls dein Standard-Branch nicht main ist (z. B. master), passe den Branchnamen entsprechend an.

Remote-Änderungen lokal pullen

Wenn ein anderer Entwickler Änderungen vorgenommen hat, verwende den folgenden Befehl, um dein lokales Repository zu aktualisieren:

git pull origin main

Dies führt die entfernten Änderungen in deinen lokalen Branch zusammen.

Häufige zusätzliche Operationen

• Remote-Repositories prüfen:

  git remote -v
  

• Später ein weiteres GitHub-Repository hinzufügen:

  git remote add origin git@github.com:your-username/another-repo.git
  

• README.md oder .gitignore bearbeiten folgt demselben Workflow.

5. Integration mit Visual Studio Code

Warum VS Code ideal für Git-Operationen ist

Beim Einsatz von GitHub auf Ubuntu verbessert die Kombination mit Visual Studio Code (VS Code) die Produktivität erheblich. VS Code ist ein von Microsoft entwickelter Open-Source-Editor und ist für seine ausgezeichnete Git-Integration bekannt. Er ermöglicht Commits, Pushes und Diff-Reviews über eine GUI, was besonders einsteigerfreundlich ist.

Installation von VS Code auf Ubuntu

Du kannst VS Code auf Ubuntu ganz einfach mit den folgenden Schritten installieren.

1. Microsoft-Repository hinzufügen

.

sudo apt update
sudo apt install wget gpg
wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > packages.microsoft.gpg
sudo install -o root -g root -m 644 packages.microsoft.gpg /usr/share/keyrings/

2. Repository registrieren

sudo sh -c 'echo "deb [arch=amd64 signed-by=/usr/share/keyrings/packages.microsoft.gpg] https://packages.microsoft.com/repos/vscode stable main" > /etc/apt/sources.list.d/vscode.list'

3. VS Code installieren

sudo apt update
sudo apt install code

Nach der Installation können Sie VS Code starten, indem Sie im Terminal code eingeben.

Integrierte Git-Unterstützung

VS Code enthält standardmäßig eine Git-Integration, sodass keine zusätzlichen Plugins für grundlegende Git‑Operationen erforderlich sind. Für erweiterte Nutzung werden die folgenden Erweiterungen empfohlen:

• GitHub Pull Requests and Issues Ermöglicht die GUI‑basierte Handhabung von Pull Requests und Issues.
• GitLens Visualisiert die Zeilen‑für‑Zeile‑Historie und zeigt, wer was und wann geändert hat.

Grundlegende Git-Operationen in VS Code

Ein Repository öffnen

Navigieren Sie zu Ihrem geklonten Repository und führen Sie aus:

code .

Änderungen prüfen und committen

• Klicken Sie auf das Quellcode‑Verwaltungs‑Symbol in der linken Seitenleiste
• Anzeigen der Liste der geänderten Dateien
• Wählen Sie eine Datei aus, um die Unterschiede zu sehen
• Geben Sie eine Commit‑Nachricht ein und klicken Sie auf das ✓‑Symbol

Push‑ und Pull‑Operationen

• Wählen Sie „Push“ oder „Pull“ aus dem „…“-Menü
• Oder verwenden Sie die Statusleiste unten rechts

Verwendung des integrierten Terminals

Das integrierte Terminal (Ctrl + `) ermöglicht nahtloses Umschalten zwischen GUI‑ und CLI‑Arbeitsabläufen. Beispielsweise können Sie über die GUI committen und über das Terminal Branches verwalten.

Fehlerbehebungstipps

• Wenn SSH‑Fehler auftreten, prüfen Sie, ob VS Code den korrekten SSH‑Schlüssel referenziert
• Möglicherweise müssen Sie die Authentifizierung neu konfigurieren oder ein GitHub Personal Access Token (PAT) verwenden

6. Häufige Fehlerbehebung

SSH‑Fehler: “Permission denied (publickey).”

Mögliche Ursachen

• SSH‑Schlüssel wurden nicht korrekt erzeugt
• Der öffentliche Schlüssel ist nicht bei GitHub registriert
• Der SSH‑Agent lädt den Schlüssel nicht

Lösungen

1. Prüfen Sie, ob ein SSH‑Schlüssel existiert:

   ls ~/.ssh/id_ed25519.pub
   

Falls er nicht existiert, erzeugen Sie einen:

ssh-keygen -t ed25519 -C "your_email@example.com"

2. Starten Sie den SSH‑Agent und fügen Sie den Schlüssel hinzu:

   eval "$(ssh-agent -s)"
   ssh-add ~/.ssh/id_ed25519
   

3. Fügen Sie den öffentlichen Schlüssel zu GitHub hinzu:

   cat ~/.ssh/id_ed25519.pub
   

Fügen Sie ihn unter “SSH and GPG keys” auf GitHub hinzu.

4. Testen Sie die Verbindung:

   ssh -T git@github.com
   

Authentifizierungsfehler mit HTTPS

Ursache

• Passwortauthentifizierung wurde eingestellt; tokenbasierte Authentifizierung ist erforderlich

Lösung

1. Erstellen Sie ein Personal Access Token auf GitHub https://github.com/settings/tokens Aktivieren Sie den repo‑Bereich beim Erstellen des Tokens
2. Verwenden Sie Ihren GitHub‑Benutzernamen und die Token‑Zeichenkette als Passwort
3. Aktivieren Sie bei Bedarf das Zwischenspeichern von Anmeldedaten:

   git config --global credential.helper cache
   

Fehler: “fatal: not a git repository”

Ursache

• Das aktuelle Verzeichnis ist kein Git‑Repository

Lösung

• Wechseln Sie in ein vorhandenes Repository‑Verzeichnis:

  cd ~/your-project-directory
  

• Oder initialisieren Sie ein neues Repository:

  git init
  

Umgang mit Merge-Konflikten

Ursache

• Konflikte entstehen, wenn mehrere Benutzer denselben Dateibereich gleichzeitig bearbeiten

Lösung

1. Öffnen Sie die konfliktbehaftete Datei nach einem git pull‑Fehler
2. Suchen Sie nach Konfliktmarkern:

   <<<<<<< HEAD
   Your changes
   =======
   Other changes
   >>>>>>> origin/main
   

3. Bearbeiten Sie den Inhalt, entfernen Sie die Marker und speichern Sie
4. Führen Sie dann aus:

   git add .
   git commit
   

Fehler: “remote: Repository not found.”

Ursache

• Falsche Repository‑URL
• Keine Zugriffsberechtigung für das Repository

Lösung

• Prüfen Sie die Remote‑URL:

  git remote -v
  

• Setzen Sie die URL bei Bedarf zurück:

.

git remote set-url origin git@github.com:your-username/your-repo.git

Diese Probleme treten häufig bei Anfängern auf. Mit klaren Ursachen und Lösungen können sie jedoch ruhig behoben werden. Betrachte Fehler als Lernchancen und baue nach und nach Vertrauen auf.

7. FAQ

F1. Was ist der Unterschied zwischen Git und GitHub?

A:
Git ist ein Versionskontrollwerkzeug, das die Änderungshistorie lokal verwaltet. GitHub ist ein Cloud‑Dienst, der Git‑Repositories hostet und das Teilen sowie die Zusammenarbeit ermöglicht.

• Git: Lokale und offline Historienverwaltung
• GitHub: Online‑Repository‑Hosting und Zusammenarbeit

F2. Sollte ich SSH oder HTTPS verwenden?

A:
SSH wird empfohlen, weil:

• Kein wiederholtes Eingeben des Passworts
• Langfristig sicherer und bequemer

Allerdings kann HTTPS in bestimmten Unternehmens‑ oder Netzwerkumgebungen erforderlich sein.

F3. Wie kann ich mehrere GitHub‑Konten unter Ubuntu nutzen?

A:
Erstelle separate SSH‑Schlüssel für jedes Konto und konfiguriere sie explizit.

1. Erstelle separate SSH‑Schlüssel, z. B.: ~/.ssh/id_ed25519_work , ~/.ssh/id_ed25519_personal
2. Bearbeite ~/.ssh/config :

   Host github.com-work
       HostName github.com
       User git
       IdentityFile ~/.ssh/id_ed25519_work
   
   Host github.com-personal
       HostName github.com
       User git
       IdentityFile ~/.ssh/id_ed25519_personal
   

3. Aktualisiere die Remote‑URL:

   git remote set-url origin git@github.com-work:your-work-user/your-repo.git
   

F4. Kann ich Git mit einer GUI verwenden?

A:
Ja. Visual Studio Code bietet GUI‑basierte Git‑Operationen, einschließlich Commits, Pushes, Diffs und Branch‑Verwaltung. Es wird für Anfänger stark empfohlen.

F5. Was passiert, wenn ich das Remote‑Repository lösche?

A:
Das Löschen eines Remote‑Repositories wirkt sich nicht auf das lokale Repository aus. Allerdings wird git push fehlschlagen.

Du kannst dich wie folgt mit einem neuen Remote verbinden:

git remote set-url origin git@github.com:new-user/new-repo.git

F6. Ist es möglich, das Terminal vollständig zu vermeiden?

A:
Ja. GUI‑Git‑Clients ermöglichen terminalfreie Workflows:

• GitKraken
• Sourcetree (nicht offiziell für Linux unterstützt)
• Visual Studio Code (eingebaute Git‑Unterstützung)

Für Ubuntu‑Nutzer ist die Kombination VS Code + GitLens am praktischsten und benutzerfreundlichsten.

F7. Wie weit zurück reicht die Git‑Historie?

A:
Git bewahrt die gesamte Historie seit dem allerersten Commit auf. Du kannst sie anzeigen mit:

git log

Um die Historie einer bestimmten Datei zu sehen:

git log path/to/file