Introduction

Avant de pouvoir suivre des modifications, créer des branches ou collaborer, vous avez besoin d'un dépôt Git — le dossier .git où Git stocke l'historique complet de votre projet. Cette section présente les quatre commandes auxquelles vous faites appel chaque fois que vous commencez à travailler avec un dépôt :

• git init — transforme un simple dossier en un nouveau dépôt vide.
• git clone — copie un dépôt existant (généralement depuis un serveur) sur votre machine.
• git config — définit votre identité et ajuste le comportement de Git.
• Git aliases — crée des noms courts et mémorables pour les commandes que vous tapez souvent.

Chaque commande dispose de sa propre page dédiée ; cette introduction vous fournit le modèle mental et une référence rapide pour savoir laquelle utiliser et quand. Si vous n'avez pas encore installé Git, commencez par Installer Git.

git init

La commande git init transforme le répertoire courant en un nouveau dépôt Git vide. Elle crée un sous-répertoire caché .git contenant tout ce dont Git a besoin pour suivre votre projet — stockage d'objets, zone de transit (index), références et un HEAD par défaut. Tant que ce répertoire n'existe pas, Git n'a rien à suivre.

Utilisez git init lorsque vous partez de zéro ou souhaitez placer un projet local existant sous contrôle de version. Aucun fichier de travail n'est modifié ni validé automatiquement — init se contente de mettre en place la mécanique.

# Start a brand-new project in the current folder
git init

# Or create the folder and initialize it in one step
git init my-project

L'exécuter sur un dossier déjà initialisé est sans danger : Git indique Reinitialized existing Git repository et conserve votre historique intact.

git clone

La commande git clone crée une copie locale d'un dépôt existant, incluant l'intégralité de son historique de commits, et le connecte pour communiquer avec l'original. C'est ainsi que la plupart des contributeurs obtiennent un projet : vous clonez une fois, puis effectuez des pull et push par la suite.

Le clonage définit automatiquement la source comme remote nommée origin, extrait la branche par défaut et crée des branches de suivi à distance pour que Git sache à quoi ressemblent les branches du serveur.

# Clone into a folder named after the repo
git clone https://github.com/user/project.git

# Clone into a custom folder name
git clone https://github.com/user/project.git my-folder

Privilégiez clone plutôt que init chaque fois que le projet existe déjà ailleurs — vous n'utilisez presque jamais git init pour un dépôt qui existe déjà sur un serveur.

git config

La commande git config lit et écrit les variables de configuration de Git, qui contrôlent tout, de votre identité de commit au comportement par défaut et aux couleurs. La configuration existe à trois niveaux, chacun remplaçant celui qui précède :

• --system — s'applique à tous les utilisateurs de la machine.
• --global — s'applique à l'utilisateur courant (stocké dans ~/.gitconfig).
• --local — s'applique uniquement au dépôt courant (valeur par défaut si aucun niveau n'est précisé).

La première chose que tout nouvel utilisateur Git doit faire est de définir son nom et son adresse e-mail, car ceux-ci sont apposés sur chaque commit :

git config --global user.name "Your Name"
git config --global user.email "[email protected]"

Pour lire une valeur ou tout lister, utilisez :

# Read one setting
git config --global user.name

# List all effective settings and where each came from
git config --list --show-origin

git alias

Un alias Git est un raccourci qui associe un nom court à une commande plus longue. Il n'existe pas de commande git alias autonome — les alias sont simplement des entrées de configuration créées avec git config (ou en modifiant directement ~/.gitconfig). Définissez-les une fois et ils vous feront gagner des frappes pour toujours.

# Now "git co" runs "git checkout"
git config --global alias.co checkout

# A richer alias: a compact, graphical log
git config --global alias.lg "log --oneline --graph --all"

Après avoir défini les alias ci-dessus, git co main se comporte exactement comme git checkout main, et git lg affiche un graphe d'historique condensé. Consultez git alias pour les alias avancés, y compris les alias de commandes shell.

Tout assembler

Une configuration initiale typique ressemble à ceci — configurez votre identité une seule fois, puis démarrez un nouveau dépôt ou clonez-en un existant :

# 1. One-time identity setup (do this once per machine)
git config --global user.name "Ada Lovelace"
git config --global user.email "[email protected]"

# 2a. Start a new project...
git init my-app

# 2b. ...or grab an existing one
git clone https://github.com/user/my-app.git

À partir de là, vous êtes prêt à indexer des modifications avec git add et à les enregistrer avec git commit.

Exercice