git clone
git
Aufruf
git clone [--depth <n>] [-b <branch>] <url> [<directory>]Kopiert ein entferntes Repository samt Historie; ein Klon mit --depth 1 hat keine alten Commits und keine anderen Branches, dafür braucht es später --unshallow.
Häufige Optionen
| Option | Bedeutung |
|---|---|
| --depth <n> | shallow copy with only the last n commits |
| -b <branch> | check out that branch instead of the default |
| --single-branch | fetch one branch only |
| --recurse-submodules | clone submodules at the same time |
| --filter=blob:none | partial clone: fetch file contents on demand |
| -o <name> | call the remote something other than origin |
Beispiele
git clone https://github.com/user/repo.gitcopies the repository into repo/ and names the remote origin
git clone --depth 1 https://github.com/user/repo.gitfast copy for CI with no old history
git clone -b dev --single-branch <url>checks out dev and fetches nothing else
Verwirrend ist, dass Rückgängig mehrere Formen hat — den Zeiger eines Branch zu verschieben ist nicht dasselbe wie einen Gegen-Commit zu setzen.
So liest man das
- Eckige Klammern [ ] markieren einen Teil, den man weglassen kann.
- Drei Punkte … heißen: mehrere sind erlaubt.
- Optionen achten auf Groß- und Kleinschreibung — bei manchen Befehlen sind -r und -R verschieden.
Häufige Fragen
Q. Was macht git clone?
Kopiert ein entferntes Repository samt Historie; ein Klon mit --depth 1 hat keine alten Commits und keine anderen Branches, dafür braucht es später --unshallow.
Q. Wie gibt man ihn ein?
git clone [--depth <n>] [-b <branch>] <url> [<directory>] — eckige Klammern markieren, was wegfallen darf.
Q. Wie viele Optionen lohnen sich?
Hier stehen 6; die vollständige Liste steht in man git. Der Befehl gehört zu git.
Verwandte Befehle
man-Seite: man git-clone