Aller au contenu

Configurer VS Code avec un compte GitHub

Ce guide présente 3 cas pratiques pour configurer Git et Visual Studio Code

Prérequis

  • Avoir déjà un compte GitHub

1. Vérifier Git & configurer son identité

Étape obligatoire

Avant toute chose, il faut vérifier si Git est installé et configurer son identité.
C’est la seule configuration indispensable pour commencer.

Vérifier l’installation

git --version

👉 Si Git n’est pas installé, télécharge-le ici : https://git-scm.com/downloads

Configurer son identité

Avant de configurer son identité, il est important de comprendre la différence entre config globale, config locale et une config système.
c'est importante surtout si on travail avec plusieurs comptes GitHub (pro/perso par exemple).

Config globale

  • Stockée dans ~/.gitconfig (ou C:\Users\TonNom\.gitconfig sur Windows).
  • Elle s’applique à tous tes dépôts sur la machine.
  • Typiquement utilisée pour l'identité principale :
    git config --global user.name
    git config --global user.email

    git config --global user.name "TonNomPrincipal"
    git config --global user.email "email_principal@example.com"

👉 Si tu fais un git commit dans n’importe quel projet, Git prendra par défaut cette identité.

Config local

  • Stockée dans .git/config à l’intérieur du dossier du projet.
  • Elle s’applique seulement à ce repo.
  • Tu peux l’utiliser quand tu veux surcharger la config globale :

pour configurer l'identité 

   git config --local user.name "AutreNom"
   git config --local user.email "autre_email@example.com"
👉 Exemple concret :

Tu as un compte GitHub perso : perso@example.com

Tu as un compte GitHub pro : pro@entreprise.com

Dans ta config globale, tu mets ton compte perso. Puis, pour ton repo pro, tu vas dans ce projet et tu définis un user.email local correspondant à ton compte entreprise.

Config système

  • S’applique à tous les utilisateurs et tous les dépôts de la machine.
  • Stockée dans /etc/gitconfig (Linux/Mac) ou parfois dans C:\Program Files\Git\etc\gitconfig (Windows).
  • Nécessite souvent les droits administrateur pour être modifiée.

Nous n'utiliserons pas la config système !

Ordre de priorité

Quand tu fais une commande Git, l’ordre est :

  1. Locale (dans .git/config)
  2. Globale (dans ~/.gitconfig)
  3. Système (dans /etc/gitconfig)

👉 La config locale écrase la globale, qui elle-même écrase la système.

pour voir toute les configs 

    git config --list --global

Depuis un dossier git : 

    git config --list

2. Cas n°1 – Cloner un dépôt existant depuis GitHub

Scénario

Tu as déjà un dépôt sur GitHub et tu veux le récupérer en local pour travailler dessus.

  1. Copier l’URL du dépôt (HTTPS ou SSH).
  2. Dans VS Code → terminal intégré :
    git clone https://github.com/utilisateur/mon-repo.git
  3. Ouvrir le dossier cloné dans VS Code.

✅ Le projet est déjà relié à GitHub. Tu peux directement commit et push.

3. Cas n°2 – Créer un projet local tout neuf

Scénario

Tu pars d’un dossier vide ou d’un projet existant qui n’a pas encore de Git.

  1. Dans VS Code, ouvrir ton dossier de projet.
  2. Initialiser Git :
    git init
  3. Ajouter un fichier (par ex. README.md).
  4. Faire un commit initial :
    git add .
git commit -m "Premier commit"
  5. Créer un repo vide sur GitHub.
  6. Relier ton projet local au repo distant :
    git remote add origin https://github.com/utilisateur/mon-repo.git
git branch -M main
git push -u origin main

4. Cas n°3 – Repo local déjà initialisé (avec .git/) mais pas encore lié à GitHub

Scénario

Tu as déjà un dossier avec .git/ (Git est initialisé), mais aucun remote n’est configuré.

  1. Vérifier si un remote existe :
    git remote -v
  2. Si rien ne s’affiche → pas de remote configuré.

  3. Si un remote existe mais que tu veux le remplacer :

    git remote remove origin

  4. Créer un nouveau repo vide sur GitHub.

  5. Ajouter ce remote à ton repo local :
    git remote add origin https://github.com/utilisateur/mon-repo.git
  6. Pousser tes commits existants :
    git branch -M main
git push -u origin main

✅ Ton projet local est maintenant lié à GitHub.

5. Utiliser Git dans VS Code

Interface VS Code

  • Onglet Source Control (icône branche dans la barre latérale).
  • Tu peux :
  • voir les fichiers modifiés
  • ajouter au staging (+)
  • écrire un message de commit
  • cliquer sur ✔ pour valider
  • cliquer sur ⟳ pour synchroniser (push/pull).

🎯 Résumé simple

À retenir

  • Cas 1 : Clone → tu pars de GitHub → git clone.
  • Cas 2 : Local vierge → tu pars de zéro → git init puis remote add.
  • Cas 3 : Local avec .git → déjà un repo Git → tu ajoutes juste un remote vers GitHub.
  • Dans tous les cas, la config minimale obligatoire est ton identité (user.name et user.email).