Les bases de Git et GitHub pour débutants

Git en GitHub, les bases pour débutants

Cet article explique comment utiliser Git et GitHub pour la gestion de versions, destiné aux développeurs qui n'ont jamais travaillé avec un système de gestion de versions.

Prérequis

- Git 2.40 ou plus récent (vérifiez avec `git --version`) - Un compte GitHub (gratuit sur github.com) - Terminal ou invite de commandes (macOS : Terminal, Windows : PowerShell, Linux : n'importe quel shell)

Étapes

1. Installez Git

Téléchargez Git depuis git-scm.com ou utilisez votre gestionnaire de paquets :

Ubuntu/Debian
sudo apt update && sudo apt install git</p><p>macOS (via Homebrew)
brew install git</p><p>Windows : téléchargez l'installateur depuis git-scm.com

Vérifiez l'installation :

git --version

2. Configurez votre identité

Git associe chaque commit à un nom et à une adresse e-mail. Cela se fait une seule fois :

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

3. Créez un dépôt

Un dépôt est le dossier dans lequel Git suit vos fichiers et leur historique. Naviguez vers votre dossier de projet et initialisez :

cd /chemin/vers/votre/projet
git init

Cela crée un dossier caché `.git` dans votre projet. Git suit désormais tous les fichiers de ce dossier.

4. Ajoutez des fichiers à la zone de staging

Git fonctionne en trois phases : le répertoire de travail, la zone de staging et le dépôt. Ajoutez d'abord des fichiers à la zone de staging :

git add .

Le point ajoute tous les fichiers du dossier actuel. Pour ajouter un seul fichier spécifique, utilisez :

git add nom-de-fichier.txt

5. Créez votre premier commit

Un commit est une capture instantanée de vos fichiers. Il enregistre l'état de la zone de staging dans l'historique du dépôt :

git commit -m "Premier commit"

Le drapeau `-m` ajoute un message. Rédigez un message court et clair qui décrit ce que vous avez modifié.

6. Créez un dépôt sur GitHub

GitHub est une plateforme cloud qui héberge des dépôts Git. Connectez-vous sur github.com, cliquez sur New repository, donnez-lui un nom et laissez toutes les options par défaut. Copiez l'URL du dépôt (par exemple `https://github.com/nom-d-utilisateur/nom-du-depot.git`).

7. Connectez votre dépôt local à GitHub

Votre dépôt local n'est pas encore lié à GitHub. Ajoutez le dépôt distant :

git remote add origin https://github.com/nom-d-utilisateur/nom-du-depot.git

`origin` est le nom par défaut de votre dépôt distant. Poussez maintenant vos commits locaux vers GitHub :

git push -u origin main

Le drapeau `-u` associe votre branche `main` locale à la branche `main` distante, afin que vous n'ayez plus qu'à taper `git push` par la suite.

8. Continuez à travailler avec des branches

Les branches vous permettent de travailler sur de nouvelles fonctionnalités sans casser le code stable. Créez une nouvelle branche et basculez dessus :

git checkout -b feature/nouvelle-fonctionnalite

Vous êtes maintenant sur une branche distincte. Les modifications que vous committez ici n'affectent pas la branche `main`. Lorsque vous avez terminé, fusionnez la branche en arrière :

git checkout main
git merge feature/nouvelle-fonctionnalite

Vérification

Vérifiez que tout fonctionne :

git status
git log --oneline

`git status` affiche l'état actuel de votre répertoire de travail. `git log --oneline` affiche une liste de tous vos commits. Si vous voyez des commits avec votre nom et votre adresse e-mail, Git fonctionne correctement. Sur GitHub, vous verrez les mêmes commits sous l'onglet Commits de votre dépôt.

Problèmes fréquents

1. `git push` demande un mot de passe

Cela se produit lorsque vous utilisez HTTPS et que vous n'avez pas configuré d'assistant d'identification. Résolvez-le en utilisant SSH :

git remote set-url origin git@github.com:nom-d-utilisateur/nom-du-depot.git

Générez d'abord une clé SSH avec `ssh-keygen -t ed25519 -C "votre@email.com"` et ajoutez la clé publique via GitHub → Settings → SSH and GPG keys.

2. `git merge` génère un conflit

Les conflits surviennent lorsque deux branches ont modifié différemment la même ligne dans le même fichier. Git marque les conflits avec `<<<<<<<` et `>>>>>>>` dans le fichier. Modifiez le fichier manuellement, supprimez les marqueurs, puis exécutez :

git add .
git commit -m "Conflit de fusion résolu"

3. Vous avez committé par erreur un fichier qui ne devait pas l'être

Supprimez le fichier du suivi mais conservez-le localement :

git rm --cached nom-de-fichier.txt
git commit -m "Supprime le fichier du suivi"

Ajoutez ensuite le fichier à `.gitignore` afin que Git l'ignore à l'avenir.

Git et GitHub vous donnent un contrôle total sur chaque modification de votre base de code, et la possibilité de collaborer sans écraser le travail des autres — mais c'est la première fois que vous annulez un commit ou que vous fusionnez une branche que vous réalisez à quel point ce contrôle est profond.