Configuration initiale de l'environnement

Avant de commencer, assurez-vous que Git est installé sur votre système. Sous Windows, téléchargez l'installateur depuis le site officiel. Sur macOS, lancez git --version dans le terminal pour déclencher l'installation si nécessaire. Sous Linux (Ubuntu), utilisez sudo apt install git.

Créez ensuite un compte sur GitHub via leur portail web. Une fois inscrit, configurez votre identité dans Git pour tracer les modifications :

git config --global user.name "UtilisateurExemple"
git config --global user.email "utilisateur@exemple.com"

Pour vérifier la configuration, exécutez git config --list.

Initialisation d'un dépôt distant sur GitHub

Connectez-vous à GitHub et créez un nouveau dépôt en cliquant sur le bouton "+" puis "New repository". Nommez-le par exemple "projet-web", choisissez sa visibilité (publique ou privée) et validez. GitHub affichera ensuite des instructions pour lier ce dépôt à votre code local.

Préparation du projet local

Placez-vous dans le dossier de votre projet via le terminal, par exemple cd /chemin/vers/projet-web. Initialisez l'environnement Git avec la commande :

git init

Cette opération crée un dossier caché .git qui stocke l'histoirque des versions.

Intégration des fichiers au suivi de version

Consultez l'état des fichiers avec git status. Pour ajouter tous les fichiers au prochain instantané, utilisez :

git add .

Enregistrez ensuite ces modifications dans l'historique local :

git commit -m "Version initiale du projet"

Connexion au dépôt GitHub

Associez votre dépôt local au dépôt distant créé sur GitHub. L'URL peut être en HTTPS ou SSH. Par exemple :

git remote add origin https://github.com/votre-nom/projet-web.git

Vérifiez la liaison avec git remote -v.

Poussée du code vers GitHub

Pour la première synchronisation, spécifiez la branche principale et le dépôt distant :

git push -u origin main

Si votre branche par défaut est "master", adaptez la commande en conséquence. Après cela, votre code sera visible sur la page GitHub du dépôt.

Routine quotidienne de développement

Lorsque vous apportez des modifications, répétez ces étapes pour mettre à jour le dépôt distant :

git add .
git commit -m "Description des changements"
git push

Cela garantit que votre travail est sauvegardé et partagé.

Résolution des problèmes fréquents

Échec d'authentification

GitHub a désactivé l'accès par mot de passe pour les opérations Git. Générez un jeton d'accès personnel dans les paramètres GitHub (Settings > Developer settings > Personal access tokens). Utilisez ce jeton comme mot de passe lors de la connexion via le terminal.

Conflit de dépôt distant

Si l'erreur "remote origin already exists" apparaît, supprimez l'ancienne liaison avec git remote remove origin puis réajoutez-la.

Échec de poussée en raison de divergences

Pour intégrer les modifications distantes, exécutez git pull origin main --rebase, résolvez les conflits éventuels, puis repoussez le code.

Techniques avancées

Pour développer des fonctionnalités sans affecter la branche principale, créez une nouvelle branche :

git checkout -b fonctionnalite-authentification

Visualisez l'historique des commits sous forme graphique avec :

git log --oneline --graph

Pour ignorer certains fichiers (comme les dépendances ou journaux), ajoutez un fichier .gitignore à la racine du projet avec des motifs tels que :

dossier_temp/
*.log
node_modules/