git remote

Teilen & Aktualisieren

Verwaltet die Remote-Repositorys, mit denen du synchronisierst

Der Befehl 'git remote' listet, ergänzt und entfernt Remotes — Kurznamen für die URLs anderer Repositorys. git clone legt eines namens origin an. Forks fügen meist ein zweites hinzu, upstream, das auf das Originalprojekt zeigt. Ein Remote hinzuzufügen lädt nichts herunter; das macht git fetch <name>.

Syntax

git remote [-v | --verbose]
git remote add <name> <url>
git remote remove <name>
git remote rename <old> <new>
git remote set-url <name> <newurl>
git remote show <name>
[ ] optional| oder<arg> Platzhalter... wiederholbar--flag Option

Optionen

Klicke auf eine Option, um sie aufzuklappen

Einsteiger (1)

Zeigt die URL jedes Remotes, für Fetch und Push.

EmpfohlenGenau sehen, von welcher URL du holst und wohin du pushst

Beispiel

git remote -v

Die richtige Option wählen

origin oder upstream

Die zwei üblichen Remotes eines Forks

BefehlZeigt aufPushst du dorthin?
originDeine Kopie (der Fork)Ja
upstreamDas OriginalprojektNein — du holst von dort

Beispiele

Remotes auflisten

git remote -v

Namen mit ihren URLs.

Das Original eines Forks hinzufügen

git remote add upstream git@github.com:acme/shop.git

Ein zweites Remote.

Eine URL ändern

git remote set-url origin git@github.com:you/shop.git

Z. B. von HTTPS auf SSH wechseln.

Details

git remote show origin

Branches und Tracking-Informationen.

Workflow-Beispiele

1
git remote add upstream git@github.com:acme/shop.git

Einmal

2
git fetch upstream

Seine Commits herunterladen

3
git merge upstream/main

Sie in dein main übernehmen

4
git push

Deinen Fork aktualisieren

Fehlerbehebung

error: remote origin already exists

Ursache: Der Name ist vergeben

Ändere es mit set-url, oder nimm einen anderen Namen

fatal: 'upstream' does not appear to be a git repository

Ursache: Das Remote ist nicht eingerichtet

Füge es mit git remote add hinzu

Tipps & Stolperfallen

Best Practices

  • ✓Nenne das Original eines Forks upstream.
  • ✓Prüfe git remote -v vor deinem ersten Push.

Häufige Fehler

  • ✗Erwarten, dass git remote add Commits herunterlädt — führe danach git fetch aus.
  • ✗In einem Fork nach upstream statt nach origin pushen.

FAQ

A:

git remote rename old new.

A:

git remote remove <name> — seine Remote-Tracking-Branches verschwinden ebenfalls.