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

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

• git init : créer un dépôt vide dans un dossier existant ou nouveau
• git clone : récupérer un projet distant avec tout son historique
• La structure .git/ : comprendre ce que Git stocke dans votre projet
• Dépôt bare vs normal : quand utiliser l’un ou l’autre

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.

Analogie

git init, c’est comme ouvrir un classeur vide pour un nouveau projet. Le classeur (le dossier .git/) est prêt à recevoir des documents, mais il est vide pour l’instant. Il ne contient que l’infrastructure nécessaire pour ranger et retrouver vos futurs documents.

Initialiser un nouveau projet

1. Créer le dossier et initialiser :

   git init mon-portfolio

   Sortie attendue :

   Dépôt Git vide initialisé dans /home/bob/Projets/mon-portfolio/.git/

2. Entrer dans le projet :

   cd mon-portfolio

3. Vérifier que Git est actif :

   git status

   Sortie attendue :

   On branch main
   No commits yet
   nothing to commit (create/copy files and use "git add" to track)

Si le dossier existe déjà, vous pouvez initialiser Git à l’intérieur :

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.

Branche par défaut

Si vous avez configuré init.defaultBranch comme indiqué dans le guide d’installation, la branche sera main. Sinon, Git crée une branche master. Les deux sont fonctionnellement identiques.

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é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

Sécurité

Ne committez jamais de mots de passe, clés API, tokens ou certificats dans Git. Une fois dans l’historique, ils sont visibles par tous ceux qui ont accès au dépôt, même si vous les supprimez ensuite. Consultez le guide secrets dans le code pour en savoir plus.

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

git clone git@github.com:username/mon-projet.git

Sortie attendue :

Clonage dans 'mon-projet'...
remote: Enumerating objects: 150, done.
remote: Counting objects: 100% (150/150), done.
remote: Compressing objects: 100% (98/98), done.
Réception d'objets: 100% (150/150), 45.20 KiB | 1.20 MiB/s, fait.
Résolution des deltas: 100% (52/52), fait.

Cloner via HTTPS

git clone https://github.com/username/mon-projet.git

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

Glissez pour voir

Exemple de clone dans un dossier personnalisé :

git clone git@github.com:git/git.git /tmp/sources-git

Sortie attendue :

Clonage dans '/tmp/sources-git'...
remote: Enumerating objects: 356178, done.
...
Résolution des deltas: 100% (267808/267808), fait.

Comprendre la structure du dossier .git/

Après un git init ou un git clone, explorez le contenu du dossier .git/ :

ls -la .git/

Sortie attendue :

drwxrwxr-x 7 bob bob 4096 mars  28 10:00 .
drwxrwxr-x 3 bob bob 4096 mars  28 10:00 ..
drwxrwxr-x 2 bob bob 4096 mars  28 10:00 branches
-rw-rw-r-- 1 bob bob   92 mars  28 10:00 config
-rw-rw-r-- 1 bob bob   73 mars  28 10:00 description
-rw-rw-r-- 1 bob bob   21 mars  28 10:00 HEAD
drwxrwxr-x 2 bob bob 4096 mars  28 10:00 hooks
drwxrwxr-x 2 bob bob 4096 mars  28 10:00 info
drwxrwxr-x 4 bob bob 4096 mars  28 10:00 objects
drwxrwxr-x 4 bob bob 4096 mars  28 10:00 refs

Chaque é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)

Glissez pour voir

Ne touchez pas à .git/

Le dossier .git/ est géré entièrement par Git. Ne modifiez jamais son contenu manuellement, sauf si vous savez exactement ce que vous faites. Supprimer .git/ détruit tout l’historique du projet.

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
Working Directory	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

Glissez pour voir

Un dépôt bare ne contient que la base de données Git, sans copie de travail. C’est ce qu’utilisent les serveurs comme GitHub et GitLab pour héberger vos projets. Vous ne travaillez jamais directement dans un dépôt bare.

git init --bare mon-serveur.git

En pratique, vous n’aurez presque jamais besoin de créer un dépôt bare. Les plateformes comme GitHub et GitLab s’en chargent.

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/GitLab exigent un Personal Access Token, pas votre mot de passe
git init crée une branche master	init.defaultBranch pas configuré	git config --global init.defaultBranch main
fatal: destination path already exists	Dossier déjà existant au clone	Supprimez le dossier ou clonez dans un autre emplacement

Glissez pour voir

À retenir

• 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

Prochaines étapes

Enregistrer des modifications Apprenez le cycle add → commit pour versionner votre travail quotidien.

Consulter l'historique Explorez l'historique de vos commits avec git log.

Le modèle Git : snapshots et 3 états Revenez aux fondamentaux si vous avez besoin de comprendre les mécanismes.

×

📖 Voir la documentation →