Comment utiliser git clone sur Ubuntu : Guide du débutant pour cloner des dépôts Git

1. Introduction

Ces dernières années, Git est devenu un outil indispensable dans le développement logiciel, la recherche et les projets personnels. En tant que système de contrôle de version utilisé dans le monde entier, Git joue un rôle majeur dans le développement d’équipes et les projets open‑source en permettant un partage et une gestion efficaces du code.

Cet article propose un guide destiné aux débutants sur la façon de cloner (dupliquer) un dépôt Git à l’aide de la commande git clone sous Ubuntu, l’une des distributions Linux les plus populaires.
La commande git clone est la manière la plus basique de copier un dépôt distant (tel que des projets hébergés sur GitHub ou GitLab) dans votre environnement local.

En maîtrisant git clone sous Ubuntu, vous pourrez installer facilement divers logiciels open‑source et configurer votre propre environnement de développement.
Cela vous aidera également à devenir plus actif dans la collaboration en équipe et au sein de la communauté.

Cet article couvre tout, de l’installation de Git, à l’utilisation de base de git clone, en passant par le dépannage des erreurs courantes.
Que vous soyez nouveau sur Git sous Ubuntu ou que vous souhaitiez organiser vos connaissances existantes, vous trouverez ici des conseils pratiques.

2. Prérequis & Configuration de l’environnement

Pour utiliser git clone sous Ubuntu, vous devez d’abord installer Git lui‑même. Vous devrez également configurer les paramètres initiaux et l’authentification pour accéder aux dépôts distants. Cette section vous guide à travers chaque étape de configuration.

2.1 Comment installer Git

Sur Ubuntu, Git peut être installé facilement depuis le dépôt officiel. Ouvrez votre terminal et exécutez les commandes suivantes dans l’ordre :

sudo apt update
sudo apt install git

Après l’installation, vérifiez que Git est correctement installé en affichant ses informations de version :

git --version

Si les informations de version s’affichent, Git est installé avec succès.

2.2 Configuration du nom d’utilisateur et de l’e‑mail

Git enregistre « qui a fait quoi et quand » à chaque modification de fichier. Ainsi, pour les nouveaux utilisateurs, il est important de définir votre nom d’utilisateur et votre adresse e‑mail :

git config --global user.name "Votre Nom"
git config --global user.email "votre.email@exemple.com"

Ce réglage global s’appliquera à toutes les opérations Git. Si vous souhaitez des paramètres spécifiques à un projet, omettez --global et exécutez la commande dans le répertoire de votre projet.

2.3 Choix et mise en place de l’authentification

Il existe deux principales méthodes d’authentification pour accéder aux dépôts distants avec Git :

• HTTPS : se connecte via une URL, comme votre navigateur. GitHub et GitLab exigent désormais un Personal Access Token (PAT) au lieu d’un mot de passe pour des raisons de sécurité.
• SSH : utilise des clés publiques et privées pour l’authentification. C’est plus sécurisé et, une fois configuré, vous évite de saisir un mot de passe à chaque utilisation — recommandé si vous utilisez Git fréquemment.

2.4 Utilisation de Git Credential Manager (GCM, optionnel)

Si vous souhaitez une gestion plus sûre et plus simple des mots de passe et des tokens, envisagez d’installer Git Credential Manager (GCM).
GCM stocke vos informations d’identification de façon sécurisée et vous évite de les retaper à chaque fois. Il est disponible pour Ubuntu via la documentation officielle ou les gestionnaires de paquets.

Voilà pour la préparation de votre environnement Ubuntu afin d’utiliser git clone.
Dans la section suivante, vous apprendrez les étapes de base pour réellement cloner un dépôt à l’aide de la commande git clone.

3. Utilisation de base de git clone

La commande git clone est le moyen principal de dupliquer le contenu d’un dépôt distant dans votre environnement local. Lorsque vous souhaitez utiliser le dépôt de quelqu’un d’autre pour des projets open‑source ou le développement en équipe, le clonage est la première étape.

3.1 Syntaxe de base de la commande

L’utilisation la plus simple est :

git clone <URL du dépôt>

Par exemple, pour cloner un dépôt public sur GitHub :

git clone https://github.com/exampleuser/sample-project.git

Cela crée un nouveau dossier nommé sample-project dans votre répertoire actuel, contenant tous les fichiers du dépôt.

3.2 Clonage via HTTPS

La plupart des services supportent le clonage via HTTPS. L’URL commence par « https:// ». Il se peut que l’on vous demande de vous authentifier (nom d’utilisateur, Personal Access Token, etc.) la première fois.

git clone https://github.com/username/repository.git

3.3 Clonage via SSH

Si vous avez enregistré une clé SSH, vous pouvez cloner de manière plus sécurisée et sans mot de passe. Le format d’URL SSH ressemble à « git@github.com:username/repository.git ».

git clone git@github.com:username/repository.git

Enregistrez votre clé publique sur GitHub ou GitLab avant d’utiliser le clonage SSH.

3.4 Structure du dépôt après le clonage

Lorsque vous exécutez git clone, tous les fichiers et répertoires — y compris le répertoire .git (qui stocke les données de contrôle de version) — sont dupliqués.

• Répertoire .git Stocke l’historique et les paramètres du dépôt. Sa présence signifie que tous les fichiers du dossier sont sous gestion Git.
• Répertoire de travail Contient le code source de votre projet, la documentation et les autres fichiers avec lesquels vous travaillez.

3.5 Faites attention au répertoire courant

git clone crée un nouveau dossier dans le répertoire où vous l’exécutez. Assurez‑vous de cd dans l’emplacement souhaité au préalable.

4. Cloner une branche spécifique

Les dépôts Git peuvent contenir plusieurs branches. Par défaut, git clone récupère la branche par défaut (comme main ou master), mais il se peut que vous vouliez cloner une branche précise. Voici comment faire :

4.1 Utilisation de l’option –branch

La commande git clone propose l’option --branch (ou -b) pour cloner une branche spécifiée.

git clone --branch nom-de-branche URL-du-dépôt

Pour cloner la branche « develop », par exemple :

git clone --branch develop https://github.com/exampleuser/sample-project.git

Cela crée un dépôt local avec la branche « develop » cochée.

4.2 Combinaison avec –single-branch

Par défaut, git clone télécharge toutes les données de branche. Ajoutez --single-branch pour ne récupérer que la branche spécifiée, ce qui économise de l’espace disque et de la bande passante.

git clone --branch nom-de-branche --single-branch URL-du-dépôt

C’est pratique pour les gros dépôts ou lorsque vous n’avez besoin que d’une branche de fonctionnalité.

4.3 Récupérer d’autres branches après le clonage

Si vous souhaitez utiliser d’autres branches plus tard, exécutez ces commandes à l’intérieur de votre dépôt :

git fetch --all

Puis changez de branche avec :

git checkout nom-de-branche

4.4 Astuces & Précautions

• Pour les dépôts privés ou restreints, vous aurez besoin d’identifiants d’authentification valides.
• Si vous spécifiez une branche inexistante, vous obtiendrez une erreur — vérifiez toujours les noms de branche sur le dépôt distant.

Profitez des options flexibles de git clone pour un flux de travail efficace, même lors du clonage de branches spécifiques.

5. Erreurs courantes et comment les corriger

Lors de l’utilisation de git clone, vous pouvez rencontrer des erreurs liées à l’authentification, à la connectivité ou aux permissions. Voici les problèmes spécifiques à Ubuntu les plus fréquents ainsi que leurs solutions :

5.1 Erreur d’authentification HTTPS & Jeton d’accès personnel (PAT)

En raison des mises à jour de sécurité, GitHub et GitLab exigent désormais des Jetons d’accès personnel (PAT) au lieu de mots de passe. Vous pouvez voir des erreurs telles que :

remote: Support for password authentication was removed...
fatal: Authentication failed for 'https://github.com/...'

Générez un PAT sur GitHub dans Settings > Developer settings > Personal access tokens. Saisissez votre nom d’utilisateur GitHub et collez le PAT lorsqu’on vous demande un mot de passe.

5.2 Erreur d’authentification SSH et enregistrement des clés publiques

Si vous voyez « Permission denied (publickey) » lors du clonage via SSH, votre clé SSH n’est peut‑être pas enregistrée.

Solution :

1. Générez une clé SSH (si vous n’en avez pas) :

   ssh-keygen -t ed25519 -C "your.email@example.com"

2. Copiez la clé publique :

   cat ~/.ssh/id_ed25519.pub

3. Ajoutez la clé aux paramètres de votre compte GitHub ou GitLab

Cela devrait résoudre les erreurs d’authentification SSH.

5.3 Erreur de permission d’accès au dépôt

Si vous essayez de cloner un dépôt privé ou d’organisation et voyez :

fatal: repository 'https://github.com/username/repository.git/' not found

Solution :

• Vérifiez l’URL du dépôt pour d’éventuelles fautes de frappe
• Assurez‑vous que votre compte possède les permissions nécessaires pour accéder au dépôt
• Saisissez à nouveau vos identifiants d’authentification

5.4 Erreurs liées au réseau

« Connection timed out » ou « Could not resolve host » indiquent généralement des problèmes de réseau.

Solution :

• Vérifiez votre connexion Internet
• Si vous utilisez un VPN ou un proxy, examinez vos paramètres
• Si GitHub est temporairement indisponible, attendez et réessayez plus tard

5.5 Autres erreurs courantes

• Le répertoire existe déjà : vous ne pouvez pas cloner dans un dossier portant le même nom. Renommez le répertoire cible ou supprimez le dossier existant.
• Espace disque insuffisant : assurez‑vous d’avoir suffisamment d’espace libre avant de cloner de gros dépôts.

En résolvant chaque problème étape par étape, vous trouverez toujours une solution.

6. Options utiles de git clone

git clone propose diverses options pour vous aider à ne récupérer que les données nécessaires, gérer les sous‑modules, etc. Voici quelques‑unes des options les plus utiles :

6.1 Option –depth (Clone superficiel)

Si vous ne voulez que l’historique du dernier commit (et non l’historique complet), utilisez l’option --depth.
Cela télécharge uniquement le nombre de commits que vous indiquez :

git clone --depth 1 https://github.com/exampleuser/sample-project.git

Cela ne récupère que le dernier commit — idéal pour les CI ou lorsque vous avez besoin de rapidité.

6.2 Option –single-branch

Par défaut, git clone récupère toutes les informations de branche. Ajoutez --single-branch pour ne cloner que la branche que vous spécifiez.
Souvent utilisé avec --branch :

git clone --branch develop --single-branch https://github.com/exampleuser/sample-project.git

Utilisez‑le lorsque vous n’avez besoin que d’une seule branche.

6.3 Option –recursive (Cloner les sous‑modules)

Certains dépôts Git utilisent des « submodules » (d’autres dépôts inclus). Utilisez --recursive pour les cloner automatiquement :

git clone --recursive https://github.com/exampleuser/sample-project.git

Si vous avez oublié --recursive, exécutez ceci après le clonage :

git submodule update --init --recursive

6.4 Autres options pratiques

• Option –origin : définir un nom de remote autre que celui par défaut (origin).
• Spécifier le nom du répertoire : ajoutez un nom de répertoire à la fin de la commande pour changer l’endroit où le dépôt est cloné.

  git clone https://github.com/exampleuser/sample-project.git your-directory-name

Combinez ces options pour rendre git clone encore plus efficace et flexible.

7. Utiliser des outils GUI pour git clone

Si vous préférez ne pas passer par la ligne de commande ou souhaitez une expérience Git plus visuelle, essayez un outil GUI (interface graphique). Ubuntu propose plusieurs outils pour faciliter le clonage de dépôts.

7.1 Outils GUI recommandés

• Gittyup : client Git léger et simple, disponible dans le dépôt officiel d’Ubuntu ou via Flatpak.
• Visual Studio Code (VS Code) : éditeur de code populaire avec de puissantes extensions Git pour des opérations Git intuitives.
• GitKraken : client visuellement attrayant et riche en fonctionnalités (gratuit pour un usage personnel).

7.2 Comment cloner avec Gittyup

1. Installez Gittyup (par ex. sudo apt install gittyup ou via Flatpak).
2. Ouvrez l’application et cliquez sur le bouton « Clone Repository ».
3. Collez l’URL du dépôt, choisissez un dossier de destination, et le dépôt sera téléchargé.

7.3 Comment cloner avec Visual Studio Code

1. Ouvrez VS Code et cliquez sur l’icône « Source Control » à gauche.
2. Sélectionnez le bouton « Clone Repository » en haut.
3. Collez l’URL du dépôt et appuyez sur Entrée. Choisissez un emplacement de sauvegarde pour lancer le clonage.
4. Une fois le clonage terminé, vous pouvez éditer le code, valider et pousser les changements—tout cela depuis VS Code.

7.4 Avantages et limites des outils GUI

• Avantages : pas besoin de taper des commandes ; idéal pour les débutants. Vous pouvez également visualiser les changements de fichiers et l’historique des commits d’un seul coup d’œil.
• Points à noter : les fonctionnalités et interfaces varient selon l’outil, choisissez donc celui qui correspond à vos besoins et préférences. Commencez avec un GUI et apprenez progressivement la ligne de commande pour des flux de travail plus flexibles.

Utiliser des outils GUI rend git clone et les autres opérations Git beaucoup plus accessibles sous Ubuntu. Combiner GUI et ligne de commande selon les besoins augmentera votre productivité.

8. Conclusion

Cet article couvre tout ce que vous devez savoir pour maîtriser git clone sur Ubuntu — de l’installation, du clonage HTTPS/SSH, des branches, des options pratiques, aux outils GUI — le tout en un seul endroit.
Une fois que vous avez appris git clone, il est utile pour les contributions open source, le développement en équipe et l’auto‑apprentissage. Le maîtriser tôt rend votre flux de travail plus fluide dans de nombreux scénarios.

Surtout pour les débutants, rappelez‑vous : « Googlez le message d’erreur ou consultez la documentation officielle si vous êtes bloqué. » Une fois à l’aise, essayez les options pratiques et les outils GUI pour améliorer vos compétences Git.

Si vous avez d’autres questions ou problèmes non résolus ici, consultez la FAQ, la documentation GitHub ou les forums communautaires.
Continuez à explorer Ubuntu et Git pour élargir vos opportunités de développement et d’apprentissage.

9. FAQ (Foire aux questions)

Q1 : Comment installer Git sur Ubuntu ?
R1 : Ouvrez votre terminal et exécutez ces commandes :

sudo apt update
sudo apt install git

Après l’installation, vérifiez avec git --version.

Q2 : Comment cloner uniquement une branche spécifique avec git clone ?
R2 : Utilisez l’option --branch (ou -b) et indiquez le nom de la branche.
Exemple :

git clone --branch nom-de-branche URL-du-dépôt

Combinez avec --single-branch si vous ne voulez que cette branche.

Q3 : J’obtiens une erreur d’authentification lors du clonage via HTTPS. Que faire ?
R3 : GitHub et GitLab exigent désormais un jeton d’accès personnel (PAT) au lieu d’un mot de passe. Créez un PAT dans les paramètres de votre compte GitHub et collez‑le lorsqu’on vous demande un mot de passe.

Q4 : Comment créer et enregistrer une clé SSH ?
R4 : Générez une clé avec :

ssh-keygen -t ed25519 -C "votre.email@exemple.com"

Copiez la clé publique (~/.ssh/id_ed25519.pub) et ajoutez‑la aux paramètres de votre compte GitHub/GitLab.

Q5 : Comment vérifier l’URL distante d’un dépôt cloné ?
R5 : Dans le répertoire du dépôt cloné, exécutez :

git remote -v

Cela affiche les URL du dépôt distant.

Q6 : Que se passe‑t‑il si un répertoire du même nom existe déjà ?
R6 : git clone échouera. Utilisez un autre nom de répertoire ou supprimez le dossier existant avant de recloner.

Q7 : Comment cloner correctement un dépôt avec des sous‑modules ?
R7 : Ajoutez --recursive lors du clonage :

git clone --recursive URL-du-dépôt

Si vous avez déjà cloné, exécutez :

git submodule update --init --recursive

pour récupérer les sous‑modules.

Q8 : Quels sont les outils GUI Git recommandés pour Ubuntu ?
R8 : Parmi les options populaires figurent Gittyup, Visual Studio Code (avec les extensions Git) et GitKraken. Choisissez ce qui convient à votre flux de travail.

Q9 : Comment passer à une autre branche après le clonage ?
R9 :

git fetch --all
git checkout nom-de-branche

Utilisez ces commandes pour changer de branche selon vos besoins.