GitHub : le guide complet pour bien débuter en 2026

GitHub est devenu le point de rendez-vous des développeurs du monde entier : on y héberge du code, on collabore, on suit des projets open source et on construit sa vitrine professionnelle. Pour un débutant, l’ensemble peut sembler intimidant — comptes, dépôts, commits, branches, pull requests. Ce guide reprend chaque brique dans l’ordre, avec des commandes réelles que vous pouvez tester immédiatement.

GitHub et Git : ce n’est pas la même chose

Première clarification, et elle est fondamentale : Git et GitHub sont deux choses distinctes.

Git est un logiciel de gestion de versions, installé sur votre machine. Il enregistre l’historique de vos fichiers, en local, même sans connexion internet.
GitHub est une plateforme en ligne qui héberge des dépôts Git et ajoute une couche de collaboration : interface web, gestion des droits, revue de code, suivi des tâches.

Autrement dit, Git fait le versioning ; GitHub héberge et partage. On peut utiliser Git sans GitHub, et il existe des alternatives à GitHub (GitLab, Bitbucket). Si ce point reste flou, notre article Git vs GitHub : quelle différence ? le détaille.

Étape 1 : créer son compte

Rendez-vous sur github.com et choisissez un nom d’utilisateur. Conseil : prenez-le au sérieux, car il apparaîtra dans toutes vos URL de projets (github.com/votre-nom/projet) et sur votre profil public. Un nom propre et professionnel vaut mieux qu’un pseudo daté.

Activez ensuite la double authentification (2FA). GitHub la rend obligatoire pour les comptes qui contribuent du code, et c’est de toute façon une bonne pratique de sécurité.

Étape 2 : installer et configurer Git

GitHub s’utilise pleinement avec Git en ligne de commande. Installez Git (git-scm.com), puis configurez votre identité une bonne fois pour toutes :

git config --global user.name "Votre Nom"
git config --global user.email "[email protected]"

# Vérifier la configuration
git config --list

L’email doit idéalement correspondre à celui de votre compte GitHub pour que vos commits vous soient bien attribués.

L’authentification : SSH ou HTTPS

Depuis plusieurs années, GitHub n’accepte plus le mot de passe pour les opérations Git. Deux options fiables :

Méthode	Avantage	Mise en place
Clé SSH	Pas de saisie répétée, sécurisé	Générer une paire de clés, ajouter la publique sur GitHub
Token HTTPS (PAT)	Simple si SSH vous rebute	Créer un Personal Access Token dans les réglages

Pour SSH :

# Générer une clé (appuyez sur Entrée pour les valeurs par défaut)
ssh-keygen -t ed25519 -C "[email protected]"

# Afficher la clé publique à copier dans GitHub > Settings > SSH keys
cat ~/.ssh/id_ed25519.pub

Étape 3 : créer un dépôt

Un dépôt (repository, ou repo) est le dossier d’un projet, avec tout son historique. Cliquez sur New repository, donnez-lui un nom, choisissez public (visible de tous) ou private (visible de vous seul et des personnes invitées), et cochez la création d’un fichier README.

Bonne pratique — Cochez « Add a README » et choisissez un .gitignore adapté à votre langage dès la création. Vous partirez sur des bases propres sans avoir à les ajouter manuellement ensuite.

Étape 4 : cloner, modifier, envoyer

Voici la boucle de travail quotidienne. On clone le dépôt en local, on modifie des fichiers, on commit les changements, puis on les push vers GitHub.

# Récupérer le dépôt en local
git clone [email protected]:votre-nom/mon-projet.git
cd mon-projet

# Après avoir modifié des fichiers : voir ce qui a changé
git status

# Indexer les changements
git add fichier.txt        # un fichier précis
git add .                  # tout le dossier courant

# Enregistrer un commit avec un message clair
git commit -m "Ajoute la page de contact"

# Envoyer vers GitHub
git push

Un commit est une photo de votre projet à un instant donné, accompagnée d’un message. Écrivez des messages descriptifs à l’impératif présent (« Corrige le bug de connexion ») : votre futur vous, et vos collègues, vous remercieront.

Étape 5 : les branches

Une branche permet de travailler sur une nouvelle fonctionnalité sans toucher à la version stable du projet, généralement la branche main. Une fois la fonctionnalité prête, on la fusionne.

# Créer une branche et s'y placer
git checkout -b nouvelle-fonctionnalite

# Travailler, commiter normalement...
git add .
git commit -m "Ajoute le formulaire d'inscription"

# Pousser la branche vers GitHub
git push -u origin nouvelle-fonctionnalite

Ce fonctionnement isole vos expérimentations. Si vous cassez quelque chose, main reste intacte. C’est le socle du travail en équipe.

Étape 6 : la pull request

La pull request (PR) est le cœur de la collaboration sur GitHub. Elle propose de fusionner votre branche dans une autre, tout en ouvrant un espace de discussion et de revue de code.

Une fois votre branche poussée, GitHub affiche un bouton Compare & pull request. Vous rédigez un titre, une description de ce que vous avez fait, et vous soumettez. Vos collègues peuvent alors :

commenter ligne par ligne,
demander des modifications,
approuver,
lancer des vérifications automatiques (tests, build).

Une fois validée, la PR est fusionnée dans main d’un clic. C’est aussi via les pull requests que vous contribuez à des projets open source. Notre guide de la pull request détaille tout le processus, y compris le workflow du fork.

Étape 7 : les issues

Les issues sont le système de suivi de GitHub. On y déclare un bug, on propose une amélioration, on ouvre une discussion. Chaque issue a un numéro, un titre, une description et peut recevoir des labels (bug, enhancement, documentation), des assignations et des jalons.

Astuce pratique : en écrivant Corrige #42 dans un message de commit ou une PR, GitHub fermera automatiquement l’issue 42 à la fusion. Le lien entre le code et la tâche se fait tout seul.

Étape 8 : soigner son README

Le fichier README.md, écrit en Markdown, est la première chose qu’un visiteur voit. Un bon README explique :

ce que fait le projet, en une phrase,
comment l’installer,
comment l’utiliser (avec un exemple),
comment contribuer.

# Mon Projet

Une application qui fait X.

## Installation

```bash
npm install
```

## Utilisation

```bash
npm start
```

C’est aussi votre vitrine : un profil GitHub avec des projets bien documentés vaut souvent mieux qu’un long CV.

Collaborer sereinement

Dès que vous travaillez à plusieurs, un réflexe s’impose : récupérer les changements des autres avant de pousser les vôtres.

# Avant de commencer à travailler, se mettre à jour
git pull

# Si un conflit survient, Git l'indique ; on l'édite puis :
git add fichier-en-conflit.txt
git commit

Les conflits de fusion font peur au début, mais ils sont normaux : Git vous montre simplement les deux versions d’une même ligne et vous laisse choisir. Rien d’irréversible.

Par où commencer concrètement

Si vous débutez, un parcours efficace : créez un compte, installez Git, créez un premier dépôt de test, faites-y trois ou quatre commits, créez une branche, ouvrez une pull request vers main. En une heure, vous aurez touché à tout le vocabulaire essentiel. Le reste — GitHub Actions, releases, wikis — viendra naturellement quand vos projets grandiront.

GitHub récompense la pratique régulière plus que la théorie. Un petit dépôt personnel maintenu chaque semaine vous apprendra davantage que dix tutoriels lus d’affilée.