Aller au contenu
English
Compte : non connecté, synchronisation possible Mon apprentissage
Selectionner le thème
English
Read in English

Créer un dépôt Git : git init et git clone

Par mis à jour le

Améliorer cette page

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).

  • 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

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.

  1. Créer le dossier et initialiser :

    Fenêtre de terminal
    git init mon-portfolio

    Sortie attendue :

    Initialized empty Git repository in /home/bob/Projets/mon-portfolio/.git/
  2. Entrer dans le projet :

    Fenêtre de terminal
    cd mon-portfolio
  3. Vérifier que Git est actif :

    Fenêtre de terminal
    git status

    Sortie attendue :

    On branch main
    No commits yet
    nothing 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 :

Fenêtre de terminal
cd mon-projet-existant
git init

Git ne modifie aucun de vos fichiers. Il crée simplement le dossier .git/ à côté de vos fichiers existants.

Avant votre premier commit, créez toujours un fichier .gitignore pour exclure les fichiers qui n'ont pas leur place dans l'historique Git :

Fenêtre de terminal
cat > .gitignore << 'EOF'
# Dépendances
node_modules/
vendor/
.venv/
# Fichiers de build
dist/
build/
*.o
# Éditeurs et IDE
.vscode/
.idea/
*.swp
# Secrets (ne JAMAIS committer)
.env
*.key
*.pem
EOF

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.

Fenêtre de terminal
git clone git@github.com:username/mon-projet.git

Remplacez 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.

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 :

Fenêtre de terminal
git clone https://github.com/octocat/Hello-World.git

Voici 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.

OptionUsageExemple
<dossier>Renommer le dossier localgit clone url mon-dossier
--depth 1Clone superficiel (dernier commit seul)Utile pour les très gros dépôts
--branch <nom>Cloner une branche spécifiquegit clone --branch develop url
--recurse-submodulesInclure les sous-modulesProjets avec dépendances Git

Exemple de clone dans un dossier personnalisé :

Fenêtre de terminal
git clone https://github.com/octocat/Hello-World.git mon-dossier

Git crée mon-dossier au lieu de Hello-World. La sortie est la même, avec Cloning into 'mon-dossier'... en première ligne.

Après un git init, explorez le contenu du dossier .git/ (un git clone y ajoute d'autres fichiers, comme index et packed-refs) :

Fenêtre de terminal
ls -la .git/

Sortie attendue :

total 40
drwxrwxr-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 HEAD
drwxrwxr-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 description
drwxrwxr-x 2 bob bob 4096 Nov 15 18:46 hooks
drwxrwxr-x 2 bob bob 4096 Nov 15 18:46 info
drwxrwxr-x 4 bob bob 4096 Nov 15 18:46 objects
drwxrwxr-x 4 bob bob 4096 Nov 15 18:46 refs

Chaque élément a un rôle précis :

Fichier / DossierRôle
HEADPointe vers la branche courante (ex : ref: refs/heads/main)
configConfiguration 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).

Git distingue deux types de dépôts :

CaractéristiqueDépôt normalDépôt bare
Copie de travailOui (vos fichiers)Non
Dossier .git/Sous-dossier du projetLe projet entier
UsageDéveloppement quotidienServeur (hébergement)
Créé avecgit initgit 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.

Fenêtre de terminal
git init --bare mon-serveur.git
ls mon-serveur.git

La 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/
HEAD
branches
config
description
hooks
info
objects
refs

Pour 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.

SymptômeCause probableSolution
fatal: not a git repositoryVous 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 SSHClé SSH pas configuréeSuivez la section SSH du guide d'installation
Clone HTTPS demande un mot de passeToken personnel requisGitHub 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 masterinit.defaultBranch pas configurégit config --global init.defaultBranch main
fatal: destination path ... already existsLe dossier cible existe déjà et n'est pas videClonez dans un autre dossier (dernier argument de git clone) ou supprimez l'ancien
  • git init crée un dépôt local vide, c'est votre point de départ pour tout nouveau projet
  • git clone copie 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 .gitignore dè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

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

10 questions
6 min.
70% requis

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