Git Init: Wie man ein Git-Repository initialisiert und einrichtet

Tutorials
Git

Hast du jemals versehentlich eine Datei gelöscht oder deinen Code überschrieben, ohne ihn wiederherstellen zu können? Ohne Versionskontrolle können solche Fehler katastrophal sein. Hier kommt git init ins Spiel – es verwandelt deinen Projektordner in ein Git-Repository und stellt sicher, dass jede Änderung nachverfolgbar und wiederherstellbar ist.

In diesem Tutorial zeige ich dir, wie du Git einrichtest, teile persönliche Tipps aus meiner Reise und helfe dir, von Anfang an einen robusten Workflow zu erstellen.

Was ist Git Init?

Der Befehl git init startet deine Reise in die Versionskontrolle. Wenn du ihn ausführst, erstellt Git einen versteckten .git-Ordner in deinem Projektverzeichnis, der Konfigurationsdaten, Commit-Historie und alle Metadaten speichert, die benötigt werden, um deine Änderungen nachzuverfolgen.

Mit jeder aufgezeichneten Modifikation kannst du sicher branchieren, zusammenführen und zusammenarbeiten – in dem Wissen, dass die komplette Historie deines Projekts immer nur einen Befehl entfernt ist.

Bild vom Autor

Wie man Git Init verwendet

Bevor wir uns mit fortgeschrittenen Themen befassen, ist es wichtig zu verstehen, wie man git init in der Praxis anwendet.

Grundlegende Verwendung von git init

Befolgen Sie diese Schritte, um ein neues Git-Repository von Grund auf zu erstellen:  

  • Öffnen Sie Ihr Terminal: Starten Sie Ihre bevorzugte Befehlszeilenschnittstelle.
  • Navigieren Sie zu Ihrem Projektverzeichnis:
cd /path/to/your/project

Dies ändert deinen aktuellen Ordner in den, den du verfolgen möchtest.

  • Das Repository initialisieren: 
git init

Nach der Ausführung dieses Befehls wird ein versteckter .git Ordner erstellt. Dieser Ordner speichert alle Informationen zur Verfolgung von Git.

  • Den Status des Repositories überprüfen:
git status

In diesem Stadium ist Git eingerichtet, verfolgt jedoch noch keine Dateien.

Ein Repository mit einem vorhandenen Projekt initialisieren

Für Projekte, die noch nicht unter Versionskontrolle stehen, können Sie Git initialisieren und Änderungen wie folgt verfolgen:

  • Navigieren Sie zu Ihrem Projektverzeichnis:
cd /path/to/your/project
  • Konvertieren Sie das Projekt in ein Git-Repository:
git init

Wie bereits erwähnt, erstellt der obige Befehl den versteckten .git Ordner, der das Git-Tracking ermöglicht.

  • Bereiten Sie Ihre Dateien vor: Da git init Dateien nicht automatisch verfolgt, fügen Sie sie mit hinzu:
git add .
  • Übertragen Sie Ihre Dateien: Speichern Sie den ersten Snapshot, indem Sie Folgendes ausführen:  
git commit -m "Initial commit"

Dieser Prozess verwandelt ein unmanaged Projekt in eines mit einer vollständigen Versionshistorie—bereit für neue Entwicklungen und Zusammenarbeit.

Git konfigurieren (falls erforderlich)

Wenn Sie den Fehler „Autoridentität unbekannt“ erhalten, bedeutet das, dass Git nicht weiß, wer Sie sind. Um dies zu beheben, konfigurieren Sie Ihre Benutzeridentität:

  • Richten Sie die Git-Benutzerdaten ein: 
git config --global user.email "[email protected]"
git config --global user.name "Your Name"

Die Verwendung von --global wendet diese Einstellungen auf alle Repositories auf Ihrem Computer an. Wenn Sie es weglassen, wird die Identität nur für das aktuelle Repository festgelegt.

  • Überprüfen Sie Ihre Konfiguration:  
git config --global user.email
git config --global user.name
  • Wiederholen Sie den Commit:  
git commit -m "First Commit"

Ich bin auf diesen Fehler gestoßen, als ich zum ersten Mal Git verwendet habe – die Festlegung meiner Identität hat das Problem gelöst.

Der erste Git-Commit wurde erfolgreich in PowerShell ausgeführt.

Verbindung zu einem Remote-Repository

Nachdem Sie ein Git-Repository lokal initialisiert haben, möchten Sie es wahrscheinlich sichern oder mit anderen zusammenarbeiten, indem Sie es mit einem Remote-Repository (z. B. GitHub, GitLab, Bitbucket) verbinden.

  • Fügen Sie ein entferntes Repository hinzu: Um Ihr lokales Repository mit einem entfernten zu verknüpfen, verwenden Sie:
git remote add origin <repository-url>

Ersetzen Sie <repository-url> durch die URL Ihres entfernten Repositories. origin ist das Standardalias für das entfernte Repository, aber Sie können jeden beliebigen Namen verwenden.

  • Sie können die Verbindung mit folgendem überprüfen:
git remote -v
  • Übertragen Sie Ihre Änderungen in das entfernte Repository:
# Übertragen Sie den ersten Commit und verfolgen Sie den entfernten Branch
git push -u origin $(git branch --show-current)  # Funktioniert für 'main' oder 'master'

Der oben genannte Befehl schiebt den aktuellen Branch und setzt ihn so, dass er den Remote-Branch verfolgt.

Wenn Sie eine ältere Git-Version verwenden, die $(git branch --show-current) nicht unterstützt, verwenden Sie:

git push -u origin main  # Oder 'master' je nach Ihrem Standardbranch

Während Sie weiter an Ihrem Projekt arbeiten, müssen Sie Änderungen aus verschiedenen Branches zusammenführen, wenn Sie mit einem Team zusammenarbeiten. Erfahren Sie, wie Sie Zusammenführungen effektiv mit diesem Git-Zusammenführungstutorial handhaben können.

Authentifizierung und Zugriff

Wenn Sie auf GitHub, GitLab oder Bitbucket pushen, müssen Sie sich möglicherweise authentifizieren. Je nach Ihrer Konfiguration können Sie:

  • Verwenden Sie SSH-Schlüssel anstelle von HTTPS-Authentifizierung (empfohlen für Sicherheit):
git remote set-url origin [email protected]:your-username/your-repo.git
  • Verwenden Sie ein Personal Access Token (PAT) anstelle eines Passworts bei der Verwendung von HTTPS. Ersetzen Sie für GitHub das Passwort durch ein Token:
git push https://[email protected]/your-repo.git

Die Verbindung zu einem entfernten Repository war ein Wendepunkt für mich – sie bestätigte, dass meine lokale Arbeit sicher gesichert und bereit für die Zusammenarbeit war. Außerdem gab es mir Vertrauen in die Versionskontrolle, da ich wusste, dass meine Historie erhalten blieb, selbst wenn mein lokales Gerät ausfiel.

Erweiterte Optionen mit Git Init

Für diejenigen, die ihre Git-Setups anpassen möchten, bieten erweiterte Optionen zusätzliche Flexibilität.

Initialisierung eines leeren Repositories

Wenn Sie einen Git-Server einrichten, auf dem Entwickler ihre Änderungen pushen, aber keine Dateien direkt bearbeiten, benötigen Sie ein leeres Repository. Ein leeres Repository enthält kein Arbeitsverzeichnis und enthält nur Versionskontrolldaten. Es wird typischerweise für Remote-Repositories verwendet:

git init --bare <repository-name>

Leere Repositories werden häufig in GitOps-Workflows verwendet, bei denen die Infrastruktur und die Anwendungsbereitstellung über Git verwaltet werden. Wenn Sie daran interessiert sind, wie GitOps die Softwarebereitstellung automatisiert und optimiert, schauen Sie sich diesen Leitfaden zu GitOps an.

Initialisierung mit spezifischer Konfiguration

Wenn Sie von Anfang an benutzerdefinierte Git-Hooks oder Konfigurationsdateien benötigen, initialisieren Sie mit einer benutzerdefinierten Vorlage:

git init --template=<template-directory>

Ich habe einmal eine benutzerdefinierte Vorlage verwendet, um essentielle Hooks automatisch zu laden, was unseren Bereitstellungsprozess im Team optimiert hat.

Best Practices für die Verwendung von Git Init

Mit Git richtig zu starten, kann Ihnen Zeit und Probleme in der Zukunft ersparen.

Organisieren Sie Ihre Projektstruktur

Bevor Sie git init ausführen, organisieren Sie Ihre Dateien in einer logischen Ordnerstruktur – trennen Sie Code, Dokumentation und Assets.

In einem Projekt, das ich geerbt habe, waren die Dateien aus mehreren Unterprojekten durcheinandergebracht, was zu Merge-Konflikten und Verwirrung führte. Durch die Neuanordnung aller Dateien in klar definierte Ordner, die Reinitialisierung des Repositories und die Einrichtung einer ordnungsgemäßen .gitignore verbesserte sich der Workflow erheblich.

Eine .gitignore-Datei frühzeitig hinzufügen

Unmittelbar nach der Initialisierung Ihres Repositories erstellen Sie eine .gitignore-Datei, um zu verhindern, dass unnötige Dateien verfolgt werden:

touch .gitignore

Bearbeiten Sie sie dann, um Regeln wie folgt einzuschließen:

# Ignoriere Abhängigkeitsordner und Protokolldateien
node_modules/
*.log
.DS_Store  # macOS-Systemdatei
Thumbs.db  # Windows-Systemdatei

Dieser Schritt hat mich vor umfangreichen Commit-Historien und potenziellen zukünftigen Konflikten bewahrt.

Für eine detaillierte Anleitung zur Konfiguration einer .gitignore-Datei, schauen Sie sich dieses gitignore-Tutorial

Häufiges Committen

Kleine, häufige Commits mit klaren Nachrichten helfen, eine detaillierte Projektgeschichte aufzubauen und erleichtern das Debugging und die Zusammenarbeit.

Fehlerbehebung bei häufigen Git-Init-Problemen

Selbst mit ordentlicher Planung können Probleme auftreten. Hier sind einige häufige Probleme und Lösungen.

Fälschlicherweise im falschen Verzeichnis initialisiert

Problem: Sie haben git init im falschen Ordner ausgeführt und haben jetzt ein unerwünschtes Git-Repository.

Lösung:  

  • Entfernen Sie das Git-Repository:
rm -rf .git

> Warnung: Dadurch wird die gesamte Versionsgeschichte für dieses Repository gelöscht. Stellen Sie sicher, dass Sie sich im richtigen Ordner befinden, bevor Sie diesen Befehl ausführen!

Navigieren Sie dann in das richtige Verzeichnis und führen Sie git init erneut aus. 

Ich habe diesen Fehler ein paar Mal gemacht, also überprüfen Sie Ihr Arbeitsverzeichnis, um ihn zu vermeiden.

Umgang mit nicht verfolgten Dateien

Problem: Nach dem Ausführen von git init verfolgt Git Ihre Dateien nicht. Das Ausführen von git status zeigt:

No commits yet  
Untracked files:
  (use "git add <file>..." to include in what will be committed)

Lösung:

  • Überprüfen Sie, ob die Dateien tatsächlich nicht verfolgt werden:
git status

Wenn Ihre Dateien unter Untracked files angezeigt werden, sieht Git sie, verfolgt sie aber noch nicht.

  • Stellen Sie dann die erforderlichen Dateien mit:
git add <file-name>
  • Committen Sie die Dateien:
git commit -m "Initial commit"

Regelmäßige Statusprüfungen stellen sicher, dass nichts Wichtiges übersehen wird.

Wenn git status keine Dateien anzeigt, prüfen Sie, ob Ihr Projekt eine .gitignore-Datei enthält, die möglicherweise wichtige Dateien ausschließt.

Fazit

Die Beherrschung von git init ist der entscheidende erste Schritt zum Aufbau eines zuverlässigen Versionskontrollsystems, das Zusammenarbeit und effizientes Projektmanagement ermöglicht. Befolgen Sie diesen Leitfaden – von der Initialisierung und Organisation Ihres Repositories bis hin zur Fehlersuche bei häufigen Problemen – um einen reibungslosen, effizienten Arbeitsablauf einzurichten.

Fangen Sie klein an – initialisieren Sie ein Testprojekt mit git init und experimentieren Sie mit dem Staging, Commiten und Pushen von Änderungen. Je früher Sie die Grundlagen von Git beherrschen, desto effizienter wird Ihr Arbeitsablauf sein! Und wenn Sie begeistert sind, Ihre Git-Fähigkeiten noch weiter zu vertiefen, schauen Sie sich diese DataCamp-Kurse an:

  • Fortgeschrittenes Git – Verbessern Sie Ihre Fähigkeiten mit fortgeschrittenen Techniken zum Branching, Merging und zur Konfliktlösung.  
  • GitHub Grundlagen – Lernen Sie, wie Sie Git nahtlos mit GitHub für kollaborative Projekte integrieren können.

Viel Spaß beim Codieren – und darauf, zuverlässige, innovative Projekte mit Git zu erstellen!

Source:
https://www.datacamp.com/tutorial/git-init