git clone

Configuration et création de projets

Copier un dépôt dans un nouveau dossier

La commande 'git clone' télécharge un dépôt — chaque commit, branche et tag — dans un nouveau dossier, extrait sa branche par défaut et retient l’adresse sous le nom de dépôt distant origin. Votre main suit origin/main, donc git pull et git push fonctionnent tout de suite. Avec --depth, vous ne téléchargez que les derniers commits.

Synopsis

git clone [<options>] <repository> [<directory>]
[ ] facultatif| ou<arg> valeur à remplacer... répétable--flag option

Options

Cliquez sur une option pour la déplier

Débutant (1)

Extraire cette branche (ou ce tag) au lieu de la branche par défaut du dépôt distant.

Si nécessaireDémarrer directement sur une autre branche

Exemple

git clone -b develop <url>

Intermédiaire (1)

Ne télécharger que le nombre donné de derniers commits (un clone superficiel). Implique --single-branch.

Si nécessaireClones rapides pour la CI ; les commandes basées sur l’historique en voient moins

Exemple

git clone --depth 1 <url>

Choisir la bonne option

Complet ou superficiel

Ce qui est téléchargé

CommandeHistoriqueIdéal pour
git clone <url>ToutTravail quotidien
git clone --depth 1 <url>Dernier commit seulementBuilds de CI, coup d’œil rapide

Exemples

Cloner en SSH

git clone git@github.com:acme/shop.git

Crée le dossier shop.

Cloner en HTTPS

git clone https://github.com/acme/shop.git

Pareil, via HTTPS.

Choisir le nom du dossier

git clone git@github.com:acme/shop.git my-shop

Clone dans my-shop.

Clone superficiel

git clone --depth 1 git@github.com:acme/shop.git

Seulement le dernier commit.

Exemples de workflows

1
git clone git@github.com:acme/shop.git

Le télécharger

2
cd shop

Y entrer

3
git switch -c feature/search

Commencer votre travail

Dépannage

Permission denied (publickey)

Cause : Votre clé SSH n’est pas configurée sur GitHub

Ajoutez votre clé à GitHub, ou clonez avec l’URL HTTPS

fatal: destination path 'shop' already exists

Cause : Un dossier de ce nom existe

Choisissez un autre nom de dossier en second argument

Repository not found

Cause : URL erronée ou pas d’accès

Vérifiez l’URL et vos droits

Astuces et pièges

Bonnes pratiques

  • ✓Utilisez des URL SSH si vous poussez souvent.
  • ✓Utilisez --depth 1 dans les pipelines de CI.

Erreurs fréquentes

  • ✗Oublier de faire cd dans le nouveau dossier avant de lancer des commandes git.
  • ✗Cloner à l’intérieur d’un autre dépôt.
  • ✗Recloner pour mettre à jour — c’est le rôle de git pull.

FAQ

A:

Oui, sous forme de branches de suivi distantes (origin/…). Passer sur l’une d’elles crée la branche locale.

A:

git fetch --unshallow.