Setup and Config
Getting and Creating Projects
Basic Snapshotting
Branching and Merging
Sharing and Updating Projects
Inspection and Comparison
Patching
Debugging
External Systems
Server Admin
Guides
- gitattributes
- Command-line interface conventions
- Everyday Git
- Frequently Asked Questions (FAQ)
- Glossary
- Hooks
- gitignore
- gitmodules
- Revisions
- Submodules
- Tutorial
- Workflows
- All guides...
Administration
Plumbing Commands
- 2.43.0 11/20/23
- 2.42.0 → 2.42.1 no changes
- 2.41.0 06/01/23
- 2.38.1 → 2.40.1 no changes
- 2.38.0 10/02/22
- 2.36.1 → 2.37.7 no changes
- 2.36.0 04/18/22
- 2.35.1 → 2.35.8 no changes
- 2.35.0 01/24/22
- 2.32.1 → 2.34.8 no changes
- 2.32.0 06/06/21
- 2.30.2 → 2.31.8 no changes
- 2.30.1 02/08/21
- 2.30.0 12/27/20
- 2.29.1 → 2.29.3 no changes
- 2.29.0 10/19/20
- 2.28.1 no changes
- 2.28.0 07/27/20
- 2.27.1 no changes
- 2.27.0 06/01/20
ÜBERSICHT
git clone [--template=<Template-Directory>] [-l] [-s] [--no-hardlinks] [-q] [-n] [--bare] [--mirror] [-o <Name>] [-b <Name>] [-u <Upload-Pack>] [--reference <Repository>] [--dissociate] [--separate-git-dir <Git-Verzeichnis>] [--depth <depth>] [--[no-]single-branch] [--no-tags] [--recurse-submodules[=<Pfad-Spezifikation>]] [--[no-]shallow-submodules] [--[no-]remote-submodules] [--jobs <n>] [--sparse] [--filter=<Filter>] [--] <Repository> [<Directory>]
BESCHREIBUNG
Klont ein Repository in ein neu erzeugtes Verzeichnis, erzeugt
Remote-Tracking-Branches zum Nachverfolgen aller Branches des geklonten
Repositorys (sichtbar durch git branch --remotes
). Zusätzlich wird der
gerade aktive Branch des geklonten Projektarchivs lokal angelegt und dessen
Inhalte geholt.
Nach dem Klonen aktualisiert ein einfaches git fetch
(ohne weitere
Argumente) alle Remote-Tracking-Branches und ein Aufruf von git pull
(ohne
weitere Argumente) wird zusätzlich die Änderungen der Remote-Branch ‚master‘
in den lokalen Master-Branch mergen (das gilt nicht, wenn „--single-branch“
angegeben wird; siehe unten).
Diese Standard-Konfiguration wird durch Anlegen einer Referenz auf den
HEAD der Remote-Branch unter refs/remotes/origin
und der Einrichtung der
Konfigurations-Variablen remote.origin.url
und remote.origin.fetch
erreicht.
OPTIONEN
- -l
- --local
-
Ist das zu klonende Projektarchiv lokal auf der Maschine, kann durch dieses Flag der normale Git-Transportmechanismus umgangen werden und es wird ein einfacher Kopiervorgang von HEAD und allen unter den objects und refs Verzeichnissen gelegenen Daten durchgeführt. Die Dateien unter .git/objects/ werden zum Platzsparen mittels hard link referenziert anstatt sie physikalisch zu kopieren.
Wenn das Repository als lokaler Pfad angegeben wird (z.B.
/Pfad/zum/Repo
), das ist ja die Voreinstellung und --local ist eigentlich überflüssig (Nulloperation). Sobald das Repository als URL angegeben wird, dann wird dieses Flag ignoriert (und wird niemals die lokalen Optimierungen anwenden). Die Angabe von--no-local
wird die Vorgabe überschreiben, wenn/Pfad/zum/Repo
angegeben wird, und stattdessen den regulären Git-Transport verwenden. - --no-hardlinks
-
Erzwingt ein physikalisches Kopieren aller Dateien im
.git/objects/
Verzeichnis anstelle von Hard-Links. Dies kann erwünscht sein, wenn eine Sicherung des Repositorys erstellt werden soll. - -s
-
Befindet sich das zu klonende Repository lokal auf der Maschine (anstatt Hard-Links zu verwenden), dann werden automatisch alle Objekte mittels
.git/objects/info/alternates
gemeinsam verwendet. Das erzeugte Repository enthält initial keine eigenen Objekte.HINWEIS: Dies kann möglicherweise gefährlich sein! Verwenden Sie diese Option nicht, wenn Sie sich nicht wirklich sicher sind. Wird ein Repository mit dieser Option geklont und man löscht z.B. später einen Branch oder führt sonst eine Git-Operation im Quellarchiv durch, die bestehende Commits dereferenziert, kann dies das geklonte Repository zerstören. Diese „gefährlichen“ Operationen können auch implizit, z.B. von
git commit
(ruft intern automatischgit gc --auto
auf) ausgeführt werden. (Siehe git-gc[1].)Man sollte beachten, dass das Ausführen von
git repack
ohne die Option--local
in einem Repository, das mit--shared
geklont wurde, Objekte aus dem Quell-Repository in ein Paket im geklonten Repository kopiert und so den vonclone --shared
eingesparten Plattenplatz entfernt. Dagegen kanngit gc
sicher ausgeführt werden, das standardmäßig die Option--local
verwendet.Wenn die Abhängigkeit eines mit
--shared
geklonten Repositorys von seinem Quell-Repository gebrochen werden soll, kann einfachgit repack -a
ausgeführt werden, um alle Objekte aus dem Quell-Repository „in einem Rutsch“ in das geklonte Repository zu kopieren. - --reference[-if-able] <Repository>
-
Wenn sich das Referenz-Repository auf dem lokalen Rechner befindet, wird automatisch
.git/objects/info/alternates
eingerichtet, um Objekte aus dem Referenz-Repository zu erhalten. Wenn, alternativ, ein bereits vorhandenes Repository verwendet wird, müssen weniger Objekte aus dem zu klonenden Repository kopiert werden, was die Belastung für Netzwerk und lokale Sicherung reduziert. Bei der Anwendung von--reference-if-able
wird ein nicht existierendes Verzeichnis mit einer Warnung übersprungen, anstatt den Klon abzubrechen.HINWEIS: Siehe den HINWEIS für die Option
--shared
und auch für die Option--dissociate
. - --dissociate
-
Objekte, die mit der Option
--reference
spezifiziert sind, von Referenz-Repositorys entlehnen. Dadurch wird der Netzwerktransfer reduziert und die Überführung von Objekten aus diesen Repositorys beendet, nachdem ein Klon mit den notwendigen lokalen Kopien der entlehnten Objekte erstellt wurden. Diese Option kann auch verwendet werden, wenn lokal von einem Repository geklont wird, das schon Objekte von einem anderen Repository übernimmt – das neue Repository wird wiederum Objekte vom selben Repository entlehnen. Diese Option kann verwendet werden, um die Übernahme zu stoppen. - -q
- --quiet
-
stille Ausführung. Auf dem Standardfehlerstrom wird kein Fortschritt ausgegeben.
- -v
- --verbose
-
„Wortreich“ ausführen. Beeinflusst nicht die Fortschrittsmeldung an den Standardfehlerstrom.
- --progress
-
Der Fortschritt wird nur standardmäßig auf der Standardfehlerausgabe angezeigt, wenn diese an ein Terminal angebunden ist, wenn nicht auch
--quiet
angegeben wird. Dieses Flag erzwingt die Fortschrittsanzeige auch ohne Terminalanbindung. - --server-option=<Option>
-
Übertragen Sie die angegebene Zeichenfolge an den Server, wenn Sie mit Protokollversion 2 kommunizieren. Die angegebene Zeichenfolge darf kein NUL- oder LF-Zeichen enthalten. Die Behandlung von Server-Optionen, einschließlich unbekannter, durch den Server ist serverspezifisch. Wenn mehrmals
--server-option=<Option>
angegeben wird, werden sie alle, wie in angegebenen Reihenfolge, an die andere Seite gesendet. - -n
- --no-checkout
-
Unterdrückt das Abrufen (checkout) von HEAD, nachdem das Klonen fertig ist.
- --bare
-
Erstellt ein
bare
Git-Repository. D.h. anstatt ein<Directory>
zu erstellen und die Verwaltungsdateien in<Directory>/.git
abzulegen, wird aus dem<Directory>
selbst das$GIT_DIR
. Dies impliziert offensichtlich--no-checkout
, weil es nirgendwo eine Möglichkeit gibt, das Arbeitsbereich auszuchecken. Auch die Branch-Heads auf der Remote-Seite werden direkt auf die entsprechenden lokalen Branch-Heads kopiert, ohne sie aufrefs/remotes/origin/
abzubilden. Wenn diese Option verwendet wird, werden weder Remote-Tracking-Branches noch die zugehörigen Konfigurationsvariablen erstellt. - --sparse
-
Initialisiert die Sparse-Checkout-Datei so, dass das Arbeitsverzeichnis nur mit den Dateien im Stammverzeichnis (root) des Repositorys beginnt. Die Sparse-Checkout-Datei kann modifiziert werden, um das Arbeitsverzeichnis nach Bedarf zu vergrößern.
- --filter=<Filter-Spezifikation>
-
Verwendet die Funktion des partiellen Klonens und fordert den Server auf, eine Teilmenge der verfügbaren Objekte, entsprechend einem vorgegebenen Objektfilter, zu senden. Bei der Verwendung von
--filter
wird die mit angegebene<filter-spec>
für den partiellen Klon-Filter verwendet. Zum Beispiel wird--filter=blob:none
alle Blobs (Dateiinhalte) herausfiltern, bis sie von Git benötigt werden. Außerdem wird--filter=blob:limit=<size>
alle BLOBs herausfiltern, die mindestens die Größe<size>
haben. Weitere Details zu den Filterspezifikationen finden Sie unter der Option--filter
in git-rev-list[1]. - --mirror
-
Erstellt einen Spiegel des Quell-Repositorys. Das enthält auch
--bare
. Im Vergleich zu--bare
bildet--mirror
nicht nur lokale Branches der Quelle auf lokale Branches des Ziel-Repositorys ab, sondern bildet auch alle Refs ab (einschließlich der Remote-Tracking-Branches, Notizen usw.). Es richtet eine refspec-Konfiguration ein, sodass alle diese Refs durch eingit remote update
im Ziel-Repository überschrieben werden können. - -o <Name>
- --origin <Name>
-
Verwendet den Namen
<Name>
stattorigin
zum Tracken der Änderungen des Upstream-Repository. - -o <Name>
- --branch <Name>
-
Anstatt dass der neu erstellte HEAD auf den Branch zeigt, auf den der HEAD des geklonten Repositorys zeigt, verweist er stattdessen auf den Branch
<Name>
. In einem „non-bare“ Repository ist dies der Branch, der ausgecheckt wird.--branch
kann auch Tags übernehmen und HEAD im resultierenden Repository von diesem Commit abtrennen. - -u <Upload-Pack>
- --upload-pack <Upload-Pack>
-
Wurde diese Option angegeben und der Zugriff auf das zu klonende Repository erfolgt über SSH, so wird damit ein Nicht-Standardpfad für den Befehlsaufruf am anderen Ende angegeben.
- --template=<Template_Directory>
-
Bestimmt das Verzeichnis, aus dem Templates ausgelesen werden sollen; (Siehe den Abschnitt "TEMPLATE DIRECTORY" in git-init[1].)
- -c <Schlüssel>=<Wert>
- --config <Schlüssel>=<Wert>
-
Setzt eine Konfigurations-Variable im neu angelegten Repository; die sofort nach der Initialisierung des Repositorys wirksam wird, noch bevor der Remote-Verlauf geholt oder irgendwelche Dateien ausgecheckt werden. Der Schlüssel hat das gleiche Format wie es von git-config[1] erwartet wird (z.B.
core.eol=true
). Wenn für den gleichen Schlüssel mehrere Werte angegeben werden, wird jeder Wert in die Konfigurationsdatei geschrieben. Auf diese Weise ist es z.B. möglich, zusätzliche Fetch-Referenzen zum Ursprungs-Remote hinzuzufügen.Aufgrund von Einschränkungen der aktuellen Implementierung werden einige Konfigurations-Variablen erst nach dem initialen Fetchen und Checkout wirksam. Bekanntermaßen nicht wirksame Konfigurations-Variablen sind:
remote.<Name>.mirror
undremote.<Name>.tagOpt
. Verwenden Sie stattdessen die entsprechenden Optionen---mirror
und--no-tags
. - --depth <Tiefe>
-
Erstellt einen „flachen“ Klon mit einem auf die angegebene Anzahl von Commits gekürzten Verlauf. Das impliziert
--single-branch
, es sei denn, es wird--no-single-branch
angegeben, um den Verlauf nahe der Spitzen aller Branches zu fetchen. Wenn Submodule gekürzt geklont werden sollen, geben Sie zusätzlich--shallow-submodules
an. - --shallow-since=<Datum>
-
Erstellt einen „flachen“, gekürzten Klon mit einem Verlauf nach dem festgelegten Zeitpunkt.
- --shallow-exclude=<Revision>
-
Erstellt einen flachen Klon mit einem Verlauf, der Commits ausschließt, die von einem angegebenen Remote-Branch oder Tag erreichbar sind. Diese Option kann mehrfach angegeben werden.
- --[no-]single-branch
-
Klont nur die Historie, die zur Spitze eines einzelnen Branchs gehört, entweder spezifiziert durch die
--branch
-Option oder den primären Branch auf den der Remote-HEAD
zeigt. Nachfolgende Fetches in das resultierende Repository werden nur den Remote-Tracking-Branch für den Branch aktualisieren, auf dem diese Option für das anfängliche Klonen verwendet wurde. Wenn der HEAD des Remote-Repositorys auf keinen Branch zeigte, als mit--single-branch
geklont wurde, wird kein Remote-Tracking-Branch erzeugt. - --no-tags
-
Klont keine Tags und setzt in der Konfiguration
remote.<Remote>.tagOpt=--no-tags
, um sicherzustellen, dass zukünftigegit pull
undgit fetch
Operationen keinen Tags folgen. Nachfolgende explizite Tag-Fetches werden trotzdem funktionieren (siehe git-fetch[1]).Kann in Verbindung mit
--single-branch
verwendet werden, um einen Branch zu klonen und zu verwalten, der außer einem einzelnen geklonten Branch keine Referenzen enthält. Das ist z.B. nützlich, um minimale Klone des Standard-Branchs eines Repositorys für die Indexierung von Suchvorgängen zu erhalten. - --recurse-submodules[=<Pfadspezifikation>]
-
Initialisiert und klont nach der Erstellung des Klons Submodule auf der Basis der angegebenen Pfadspezifikation. Wenn keine Pfadspezifikation angegeben wird, werden alle Submodule initialisiert und geklont. Diese Option kann für Pfadspezifikationen, die aus mehreren Einträgen bestehen, mehrfach angegeben werden. Der resultierende Klon hat
submodule.active
oder "." (d.h. alle Submodule) auf die angegebene Pfadspezifikation gesetzt, wenn keine Pfadspezifikation vorhanden ist.Submodule werden mit ihren Standardeinstellungen initialisiert und geklont. Dies entspricht dem Ausführen von
git submodule update --init --recursive <Pfadspezifikation>
unmittelbar, nachdem der Klon beendet ist. Diese Option wird ignoriert, wenn das geklonte Repository keinen Arbeitsbereich/Checkout hat (d.h. wenn eine der Optionen--no-checkout
/-n
,--bare
oder--mirror
angegeben wurde) - --[no-]shallow-submodules
-
Alle zu klonenden Submodule werden auf eine Tiefe von 1 gekürzt.
- --[no-]remote-submodules
-
Alle geklonten Submodule verwenden den Status der Remote-Tracking-Branch des Submoduls, um das Submodul zu aktualisieren, aber nicht den registrierten SHA-1 des Hauptprojekts. Das entspricht der Option von
--remote
mit dem Befehlgit submodule update
. - --separate-git-dir=<Git-Dir>
-
Verwendet das angegebene Verzeichnis als Speicherort für das geklonte Repository, anstatt das übliche Verzeichnis zu verwenden. Dann wird ein Dateisystem-unabhängiger, symbolischer Git-Link dorthin erstellt. Das führt dazu, dass das Git-Repository vom Arbeitsbereich getrennt werden kann.
- -j <Anz>
- --jobs <Anz>
-
Anzahl der gleichzeitig abgerufenen Submodule. Standardmäßig wird die Option
submodule.fetchJobs
verwendet. - <Repository>
-
Bezeichnet das (möglicherweise externe) Repository, das geklont werden soll. Siehe unten den Abschnitt GIT URLS für weiterführende Informationen zum Bestimmen von Repositorys.
- <Directory>
-
Der Name eines neuen Verzeichnisses, in das geklont werden soll. Der „menschenfreundliche“ Teil des Quell-Repositorys wird verwendet, wenn kein Verzeichnis explizit angegeben wird (
repo
für/path/to/repo.git
undfoo
fürhost.xz:foo/.git
). Das Klonen in ein bestehendes Verzeichnis ist nur erlaubt, wenn das Verzeichnis leer ist.
GIT URLS
Im Allgemeinen enthalten URLs Informationen über das Transportprotokoll, die Adresse des Remote-Servers und den Pfad zum Repository. Je nach Transportprotokoll können einzelne dieser Informationen fehlen.
Git unterstützt die Protokolle SSH, GIT, HTTP und HTTPS (zusätzlich könnte FTP und FTPS zum Abrufen verwendet werden, aber die sind ineffizient und veraltet; bitte nicht verwenden).
Der native Transport (d.h. git:// URL) führt keine Authentifizierung durch und sollte in ungesicherten Netzwerken mit Vorsicht verwendet werden.
Folgende Syntaxen können damit verwendet werden:
-
ssh://[user@]host.xz[:port]/Pfad/zum/Repo.git/
-
git://host.xz[:port]/Pfad/zum/Repo.git/
-
http[s]://host.xz[:port]/Pfad/zum/Repo.git/
-
ftp[s]://host.xz[:port]/Pfad/zum/Repo.git/
Eine alternative, scp-ähnliche Syntax kann auch mit dem Protokoll SSH verwendet werden:
-
[user@]host.xz:Pfad/zum/Repo.git/
Diese Syntax wird nur erkannt, wenn vor dem ersten Doppelpunkt keine
Schrägstriche stehen. Dadurch kann ein lokaler Pfad, der einen Doppelpunkt
enthält, besser erkannt werden. Zum Beispiel könnte der lokale Pfad
foo:bar
als absoluter Pfad oder ./foo:bar
angegeben werden, um zu
vermeiden, dass er als SSH-URL fehlinterpretiert wird.
Die Protokolle SSH und GIT unterstützen zusätzlich die Erweiterung ~username:
-
ssh://[user@]host.xz[:port]/~[user]/Pfad/zum/Repo.git/
-
git://host.xz[:port]/~[user]/Pfad/zum/Repo.git/
-
[user@]host.xz:/~[user]/Pfad/zum/Repo.git/
Für lokale Repositorys, die von Git ebenfalls nativ unterstützt werden, können die folgenden Syntaxen verwendet werden:
-
/Pfad/zum/Repo.git/
-
file:///Pfad/zum/Repo.git/
Diese beiden Syntaxen sind größtenteils äquivalent, außer dass die erstgenannte die Option --local beinhaltet.
git clone, git fetch und git pull, aber nicht git push, akzeptieren auch eine geeignete Bundle-Datei. Siehe git-bundle[1].
Wenn Git nicht versteht, wie ein bestimmtes Transportprotokoll zu verwenden ist, versucht es, das Remote-<Transport>-Hilfsprogramm zu benutzen, falls es eines gibt. Um ein Remote-Hilfsprogramm explizit anzufordern, kann die folgende Syntax verwendet werden:
-
<Transport>::<Adresse>
wobei <Adresse> ein Pfad, ein Server und Pfad oder eine beliebige URL-ähnliche Zeichenfolge sein kann, die von dem aufgerufenen, spezifischen Remote-Hilfsprogramm erkannt wird. Siehe gitremote-helpers[7] für weitere Details.
Wenn es eine große Anzahl ähnlich benannter Remote-Repositorys gibt und Sie für diese ein anderes Format verwenden möchten (sodass die von Ihnen verwendeten URLs in funktionierende URLs umgeschrieben werden), kann ein Konfigurations-Abschnitt in dieser Form erstellt werden:
[url "<aktuelle URL-Basis>"] insteadOf = <andere URL-Basis>
Beispielsweise mit folgendem:
[url "git://git.host.xz/"] insteadOf = host.xz:/Pfad/zu/ insteadOf = work:
eine URL wie "work:Repo.git" oder wie "host.xz:/fad/zu/Repo.git" wird in jedem Kontext umgeschrieben, der eine URL zu "git://git.host.xz/Repo.git" umwandelt.
Wenn Sie URLs nur zum Pushen neu schreiben möchten, können Sie einen Konfiguration-Abschnitt in der folgenden Form erstellen:
[url "<aktuelle URL-Basis>"] pushInsteadOf = <andere URL-Basis>
Beispielsweise mit folgendem:
[url "ssh://example.org/"] pushInsteadOf = git://example.org/
eine URL wie „git://example.org/path/to/repo.git“ wird für Pushes in „ssh://example.org/path/to/repo.git“ umgeschrieben, aber Pulls verwenden weiterhin die Original-URL.
BEISPIELE
-
Klonen eines Upstream-Repositorys:
$ git clone git://git.kernel.org/pub/scm/.../linux.git my-linux $ cd my-linux $ make
-
Erstellt einen lokalen Klon, der vom aktuellen Verzeichnis entlehnt wird, ohne die Daten auszuchecken:
$ git clone -l -s -n . ../copy $ cd ../copy $ git show-branch
-
Klonen eines Upstream-Repositorys wobei Objekte von einem lokalen Repository entlehnt werden:
$ git clone --reference /git/linux.git \ git://git.kernel.org/pub/scm/.../linux.git \ my-linux $ cd my-linux
-
Erzeugt ein „leeres“ (bare) Repository um Ihre Änderungen zu veröffentlichen:
$ git clone --bare -l /home/proj/.git /pub/scm/proj.git
GIT
Teil der git[1] Suite