Ce guide vous montre comment créer votre premier dépôt Git ou
récupérer un projet existant. Vous utiliserez git init pour démarrer
un nouveau projet et git clone pour récupérer un projet distant.
À la fin, vous comprendrez ce que contient le dossier .git/ et
pourquoi il est essentiel.
Prérequis : Git installé et configuré (identité, éditeur).
Ce que vous allez apprendre
Section intitulée « Ce que vous allez apprendre »- Créer un dépôt vide avec
git init, dans un dossier nouveau ou déjà existant - Récupérer un projet distant avec tout son historique, grâce à
git clone - Lire le contenu du dossier
.git/, où Git range ce qu'il stocke dans votre projet - Choisir entre un dépôt normal et un dépôt bare
Créer un dépôt local avec git init
Section intitulée « Créer un dépôt local avec git init »La commande git init transforme un dossier ordinaire en dépôt Git.
Elle crée un sous-dossier .git/ qui contient toute la mécanique de
versioning.
Initialiser un nouveau projet
Section intitulée « Initialiser un nouveau projet »-
Créer le dossier et initialiser :
Fenêtre de terminal git init mon-portfolioSortie attendue :
Initialized empty Git repository in /home/bob/Projets/mon-portfolio/.git/ -
Entrer dans le projet :
Fenêtre de terminal cd mon-portfolio -
Vérifier que Git est actif :
Fenêtre de terminal git statusSortie attendue :
On branch mainNo commits yetnothing to commit (create/copy files and use "git add" to track)
Git écrit ses messages dans la langue du système. Les sorties de ce guide
sont en anglais (LANG=C.UTF-8). Avec LANG=fr_FR.UTF-8, Git 2.47.3
traduit git init et git status (« Dépôt Git vide initialisé », « Sur
la branche main »), mais pas git diff ni git log. Sur un système en
français, vous lirez donc d'autres mots pour le même sens.
Si le dossier existe déjà, vous pouvez initialiser Git à l'intérieur :
cd mon-projet-existantgit initGit ne modifie aucun de vos fichiers. Il crée simplement le dossier
.git/ à côté de vos fichiers existants.
Créer un .gitignore dès le départ
Section intitulée « Créer un .gitignore dès le départ »Avant votre premier commit, créez toujours un fichier .gitignore pour
exclure les fichiers qui n'ont pas leur place dans l'historique Git :
cat > .gitignore << 'EOF'# Dépendancesnode_modules/vendor/.venv/
# Fichiers de builddist/build/*.o
# Éditeurs et IDE.vscode/.idea/*.swp
# Secrets (ne JAMAIS committer).env*.key*.pemEOFCloner un dépôt distant avec git clone
Section intitulée « Cloner un dépôt distant avec git clone »La commande git clone télécharge un projet distant avec tout son
historique. C'est l'équivalent de photocopier un classeur complet au
lieu de le créer de zéro.
Cloner via SSH (recommandé)
Section intitulée « Cloner via SSH (recommandé) »git clone git@github.com:username/mon-projet.gitRemplacez username/mon-projet par un dépôt auquel votre compte a accès.
Cette forme utilise la clé SSH configurée dans le
guide d'installation :
aucun mot de passe à saisir.
Cloner via HTTPS
Section intitulée « Cloner via HTTPS »Le dépôt public octocat/Hello-World, un dépôt de démonstration de GitHub,
se clone sans compte. Vous pouvez donc l'essayer tout de suite :
git clone https://github.com/octocat/Hello-World.gitVoici la sortie observée avec Git 2.47.3. Les nombres changent d'un dépôt à
l'autre, ils sont remplacés ici par ... :
Cloning into 'Hello-World'...remote: Enumerating objects: ..., done.remote: Total ... (delta ...), reused ... (delta ...), pack-reused ... (from ...)Receiving objects: 100% (.../...), done.Git crée le dossier Hello-World et y télécharge tout l'historique du
projet. Les lignes qui commencent par remote: viennent du serveur, qui
prépare l'envoi. La ligne Receiving objects vous dit que votre machine
reçoit ces données. Cette ligne de progression n'apparaît que dans un
terminal, pas dans un script ou un journal d'intégration continue.
Sur un dépôt à l'historique plus long, vous verrez aussi une ligne
Resolving deltas: 100% (.../...), done.. Un delta est la différence
entre deux versions d'un même fichier, que le serveur envoie à la place du
fichier complet. Hello-World est minuscule : le serveur n'envoie aucun
delta, donc cette ligne n'apparaît pas.
Entrez ensuite dans le dossier avec cd Hello-World, puis lancez
git log --oneline. Les commits du projet s'affichent sans nouvelle
connexion au serveur, parce que tout l'historique est déjà sur votre
machine.
Options utiles de git clone
Section intitulée « Options utiles de git clone »| Option | Usage | Exemple |
|---|---|---|
<dossier> | Renommer le dossier local | git clone url mon-dossier |
--depth 1 | Clone superficiel (dernier commit seul) | Utile pour les très gros dépôts |
--branch <nom> | Cloner une branche spécifique | git clone --branch develop url |
--recurse-submodules | Inclure les sous-modules | Projets avec dépendances Git |
Exemple de clone dans un dossier personnalisé :
git clone https://github.com/octocat/Hello-World.git mon-dossierGit crée mon-dossier au lieu de Hello-World. La sortie est la même, avec
Cloning into 'mon-dossier'... en première ligne.
Comprendre la structure du dossier .git/
Section intitulée « Comprendre la structure du dossier .git/ »Après un git init, explorez le contenu du dossier .git/ (un
git clone y ajoute d'autres fichiers, comme index et packed-refs) :
ls -la .git/Sortie attendue :
total 40drwxrwxr-x 7 bob bob 4096 Nov 15 18:46 .drwxrwxr-x 3 bob bob 4096 Nov 15 18:46 ..-rw-rw-r-- 1 bob bob 21 Nov 15 18:46 HEADdrwxrwxr-x 2 bob bob 4096 Nov 15 18:46 branches-rw-rw-r-- 1 bob bob 92 Nov 15 18:46 config-rw-rw-r-- 1 bob bob 73 Nov 15 18:46 descriptiondrwxrwxr-x 2 bob bob 4096 Nov 15 18:46 hooksdrwxrwxr-x 2 bob bob 4096 Nov 15 18:46 infodrwxrwxr-x 4 bob bob 4096 Nov 15 18:46 objectsdrwxrwxr-x 4 bob bob 4096 Nov 15 18:46 refsChaque élément a un rôle précis :
| Fichier / Dossier | Rôle |
|---|---|
HEAD | Pointe vers la branche courante (ex : ref: refs/heads/main) |
config | Configuration locale du dépôt (niveau --local) |
objects/ | Stocke tous les objets Git (commits, arbres, fichiers) |
refs/ | Contient les pointeurs de branches et tags |
hooks/ | Scripts exécutés automatiquement à certains événements |
info/ | Fichiers d'information (ex : exclusions locales) |
Dans la liste affichée plus haut, vous pouvez ignorer description
(utilisé seulement par l'interface web GitWeb) et branches/ (un ancien
mécanisme que Git n'utilise plus).
Dépôt normal vs dépôt bare
Section intitulée « Dépôt normal vs dépôt bare »Git distingue deux types de dépôts :
| Caractéristique | Dépôt normal | Dépôt bare |
|---|---|---|
| Copie de travail | Oui (vos fichiers) | Non |
Dossier .git/ | Sous-dossier du projet | Le projet entier |
| Usage | Développement quotidien | Serveur (hébergement) |
| Créé avec | git init | git init --bare |
Un dépôt bare ne contient que la base de données Git, sans copie de
travail. Un serveur Git qui reçoit des push en a besoin, comme celui de la
leçon héberger un serveur Git.
Vous ne travaillez jamais directement dans un dépôt bare.
git init --bare mon-serveur.gitls mon-serveur.gitLa commande crée le dossier mon-serveur.git et y place directement les
éléments de .git/, sans répertoire de travail :
Initialized empty Git repository in /home/bob/Projets/mon-serveur.git/HEADbranchesconfigdescriptionhooksinfoobjectsrefsPour un projet personnel, vous n'aurez pas besoin de créer un dépôt bare : une plateforme d'hébergement comme GitHub ou GitLab gère le côté serveur à votre place.
Dépannage : problèmes courants
Section intitulée « Dépannage : problèmes courants »| Symptôme | Cause probable | Solution |
|---|---|---|
fatal: not a git repository | Vous n'êtes pas dans un dossier contenant .git/ | Naviguez dans le bon dossier avec cd ou initialisez avec git init |
Permission denied (publickey) au clone SSH | Clé SSH pas configurée | Suivez la section SSH du guide d'installation |
| Clone HTTPS demande un mot de passe | Token personnel requis | GitHub n'accepte plus le mot de passe du compte pour Git, et GitLab exige un Personal Access Token dès que la double authentification est active |
git init crée une branche master | init.defaultBranch pas configuré | git config --global init.defaultBranch main |
fatal: destination path ... already exists | Le dossier cible existe déjà et n'est pas vide | Clonez dans un autre dossier (dernier argument de git clone) ou supprimez l'ancien |
À retenir
Section intitulée « À retenir »git initcrée un dépôt local vide, c'est votre point de départ pour tout nouveau projetgit clonecopie un dépôt distant avec tout son historique- Le dossier
.git/contient toute la mécanique de Git, ne le supprimez pas - Créez un
.gitignoredès le premier commit pour exclure les fichiers indésirables - Ne committez jamais de secrets : mots de passe, clés API, tokens
- SSH est recommandé pour cloner : plus sécurisé et sans saisie de mot de passe
- Un dépôt bare n'a pas de copie de travail : il sert de serveur, et vous n'y travaillez jamais directement
Contrôle de connaissances
Section intitulée « Contrôle de connaissances »Vérifiez que l'essentiel de ce guide est acquis. Les questions portent uniquement sur ce qui vient d'être expliqué ici.
Contrôle de connaissances
Validez vos connaissances avec ce quiz interactif
Informations
- Le chronomètre démarre au clic sur Démarrer
- Questions à choix multiples, vrai/faux et réponses courtes
- Vous pouvez naviguer entre les questions
- Les résultats détaillés sont affichés à la fin
Lance le quiz et démarre le chronomètre
Vérification
(0/0)Score par domaine
Un domaine regroupe plusieurs guides et reçoit plusieurs questions : son score est plus fiable qu'un score par thème, qui porte souvent sur une seule question.
Bilan
Points forts
Aucun sujet réussi à 80 % sur au moins deux questions pour l’instant.
Points faibles
Aucun sujet sous le seuil de réussite.
À faire ensuite
Des indices pour retenter votre chance ?
Continuer le cours : Enregistrer des modifications
Continuer le cours : Enregistrer des modifications : add, diff, commit
Nouveau quiz complet avec des questions aléatoires
Retravailler uniquement les questions ratées
Retour à la liste des certifications