Erste Schritte mit Git: Repositories initialisieren und klonen

Das Initialisieren und Klonen von Repositories sind die beiden grundlegenden Methoden, um mit Git zu arbeiten. Entweder Sie verwandeln einen vorhandenen Ordner in ein Git-Repository, oder Sie kopieren ein vorhandenes Repository, um mit dessen Dateien und Verlauf arbeiten zu können.

Diese Befehle sehen einfach aus, aber die Entscheidungen, die Sie zu Beginn treffen, beeinflussen Remotes, Branches, ignorierte Dateien und Team-Workflows. Eine saubere Einrichtung verhindert spätere Verwirrung.

Was ein Git-Repository enthält

Ein Git-Repository ist ein Projektordner mit einem versteckten .git-Verzeichnis darin. Dieses .git-Verzeichnis speichert die Commit-Historie, Branch-Referenzen, Remote-Informationen, Konfiguration und die interne Objektdatenbank von Git.

Normalerweise bearbeiten Sie .git-Dateien nicht von Hand. Sie verwenden Git-Befehle, und Git aktualisiert diese internen Daten für Sie.

Um zu überprüfen, ob ein Ordner bereits ein Repository ist, führen Sie aus:

git status

Wenn Git sagt, dass der Ordner kein Repository ist, können Sie eines initialisieren. Wenn es einen Branch, geänderte Dateien oder einen sauberen Arbeitsbaum anzeigt, verfolgt Git diesen Ordner bereits.

Es hilft, drei häufige Bereiche zu verstehen:

• Arbeitsbaum: die Dateien, die Sie sehen und bearbeiten können.
• Staging-Bereich: die Änderungen, die für den nächsten Commit ausgewählt wurden.
• Repository-Verlauf: die Commits, die Git bereits aufgezeichnet hat.

Wenn Sie ein Repository initialisieren oder klonen, richtet Git diese Teile ein, sodass Sie mit dem Erstellen von Commits beginnen können.

Initialisieren eines neuen Repositorys

Verwenden Sie git init, wenn Sie einen lokalen Projektordner haben, der noch nicht von Git verfolgt wird.

Erstellen Sie einen Ordner und initialisieren Sie ihn:

mkdir my-app
cd my-app
git init

Git erstellt das versteckte .git-Verzeichnis. Sie können jetzt Dateien hinzufügen und Ihren ersten Commit erstellen:

echo "# My App" > README.md
git add README.md
git commit -m "README hinzugefügt"

Wenn Ihr Standard-Branch main heißen soll, können Sie das global festlegen, bevor Sie neue Repositories erstellen:

git config --global init.defaultBranch main

Oder benennen Sie den aktuellen Branch nach der Initialisierung um:

git branch -M main

Für ein echtes Projekt erstellen Sie vor Ihrem ersten großen Commit eine .gitignore. Dies verhindert, dass Abhängigkeitsordner, Build-Ausgaben, Protokolle und lokale Geheimnisse in den Verlauf gelangen:

node_modules/
dist/
.env
*.log

Sobald eine Datei committet wurde, entfernt das spätere Hinzufügen zu .gitignore sie nicht aus dem Verlauf. Deshalb sind frühe Ignorier-Regeln wichtig.

Wenn Sie das Repository auf einem Hosting-Dienst veröffentlichen möchten, erstellen Sie dort zuerst das leere Remote-Repository und verbinden Sie es dann:

git remote add origin [email protected]:example/my-app.git
git push -u origin main

Die Option -u legt das Upstream-Tracking fest. Danach wissen einfache git push- und git pull-Befehle, welchen Remote-Branch sie verwenden sollen.

Klonen eines vorhandenen Repositorys

Verwenden Sie git clone, wenn ein Repository bereits woanders existiert. Das Klonen kopiert die Projektdateien, den Verlauf und die Remote-Konfiguration.

Der grundlegende Befehl lautet:

git clone [email protected]:example/my-app.git

Git erstellt einen Ordner, der nach dem Repository benannt ist. Um einen anderen lokalen Ordnernamen zu wählen, fügen Sie ihn am Ende hinzu:

git clone [email protected]:example/my-app.git worktree-app

Nach dem Klonen wechseln Sie in den Ordner und überprüfen ihn:

cd worktree-app
git status
git remote -v
git branch

Standardmäßig heißt der Remote normalerweise origin. Dieser Name ist konventionell, nicht magisch. Er zeigt auf die URL, die Git für Abrufe und Übertragungen verwendet.

Sie können entweder HTTPS- oder SSH-Clone-URLs sehen. HTTPS ist einfach zu beginnen, besonders für öffentliche Repositories. SSH ist für die tägliche Entwicklung üblich, da es Schlüssel verwendet und bei korrekter Konfiguration wiederholte Passwortabfragen vermeidet.

Für ein großes Repository könnten Sie einen flachen Klon verwenden:

git clone --depth 1 https://example.com/repo.git

Dies lädt nur die aktuelle Historie herunter. Es ist nützlich für CI-Jobs oder schnelle Überprüfungen, kann aber Befehle einschränken, die ältere Commits, Tags oder die vollständige Historie benötigen. Für die normale Entwicklung ist ein vollständiger Klon normalerweise besser.

Wenn das Repository Submodule verwendet, klonen Sie mit:

git clone --recurse-submodules [email protected]:example/platform.git

Oder initialisieren Sie sie nach dem Klonen:

git submodule update --init --recursive

Submodule fügen eine weitere Ebene der Repository-Verwaltung hinzu, lesen Sie daher die Projektdokumentation, bevor Sie Änderungen vornehmen.

Häufige erste Überprüfungen nach der Einrichtung

Nach dem Initialisieren oder Klonen führen Sie einige Überprüfungen durch, bevor Sie mit dem Programmieren beginnen. Sie helfen, Fehlkonfigurationen frühzeitig zu erkennen.

Überprüfen Sie Ihre Identität:

git config user.name
git config user.email

Wenn dies ein Arbeits-Repository ist, stellen Sie sicher, dass die E-Mail mit Ihrem Firmenkonto übereinstimmt. Sie können sie lokal festlegen:

git config --local user.email "[email protected]"

Überprüfen Sie Remotes:

git remote -v

Stellen Sie sicher, dass die Fetch- und Push-URLs auf das erwartete Repository verweisen. Ein versehentliches Pushen zu einem Fork oder persönlichen Spiegel kann Zeit verschwenden.

Überprüfen Sie den aktuellen Branch:

git branch --show-current

Wenn Sie ein Repository geklont haben, lesen Sie die README oder den Beitragsleitfaden, bevor Sie einen Branch erstellen. Viele Teams erwarten Branchnamen wie feature/ticket-123-short-description oder fix/login-timeout.

Überprüfen Sie vor Ihrem ersten Commit die ignorierten Dateien:

git status --ignored

Dies ist eine schnelle Möglichkeit, um zu bestätigen, dass Build-Artefakte und lokale geheime Dateien nicht committet werden.

Wann Sie um Hilfe bitten sollten

Fragen Sie einen Teamkollegen oder Repository-Betreuer um Hilfe, wenn Sie unsicher sind, welche Remote-URL Sie verwenden sollen, ob Sie einen Fork oder das Haupt-Repository klonen sollen oder wie Submodule behandelt werden sollen.

Sie sollten auch innehalten, wenn Sie Git im falschen Verzeichnis initialisiert haben. Zum Beispiel kann das Ausführen von git init in Ihrem Home-Ordner dazu führen, dass Git Tausende von nicht zusammenhängenden Dateien sieht. Löschen Sie nicht wahllos Dinge. Bestätigen Sie, wo .git erstellt wurde, und entfernen Sie nur die irrtümlichen Repository-Metadaten, wenn Sie sicher sind, dass sie keine benötigte Historie enthalten.

Der Einstieg mit Git dreht sich hauptsächlich um saubere Gewohnheiten. Verwenden Sie git init für neue lokale Projekte, git clone für vorhandene Repositories, und überprüfen Sie Ihren Branch, Remote, Identität und ignorierte Dateien, bevor Sie mit der ernsthaften Arbeit beginnen.