Programmation
Référence consultable pour comprendre les dépôts, branch, commit, la synchronisation, les PR, les conflits et les actions Git sûres.
33 termes
Concepts de base
Repository
engineerdoge/math-ai-toolsUn dossier de projet suivi par Git, généralement reflété sur GitHub.
Lorsque vous demandez à inspecter un projet, à valider des modifications ou à comparer des branches, le dépôt est l'unité qui est traitée.
engineerdoge/math-ai-toolsVérifier l'état du dépôt actuel.
Concepts de base
Working tree
git statusLes fichiers actuellement extraits sur votre machine, y compris les modifications qui ne sont pas encore validées.
Utilisez-le pour séparer l'historique des modifications de l'historique des modifications actuellement en cours.
git statusAfficher les modifications apportées à l'arborescence de travail.
Concepts de base
Staging area
git add src/components/SiteHeader.tsxUne sélection temporaire de modifications qui seront incluses dans le prochain commit.
Il vous permet de ne valider que les fichiers ou les blocs qui appartiennent ensemble.
La préparation ne sauvegarde pas l'historique en elle-même. C'est le commit qui l'enregistre.
git add src/components/SiteHeader.tsxAjouter uniquement les fichiers pour la page des termes Git.
Concepts de base
Commit
git commit -m "Add Git terms reference"Une capture instantanée enregistrée des modifications sélectionnées dans l'historique du dépôt.
Les commits permettent de revoir, de comparer, de déployer ou d'annuler les modifications ultérieurement.
git commit -m "Add Git terms reference"Créer un commit avec un message concis.
Concepts de base
Diff
git diffUne vue ligne par ligne de ce qui a changé entre deux états de fichier.
Le diff est le moyen le plus rapide de vérifier exactement ce qu'une modification a apporté avant de valider.
git diffExaminer les modifications apportées pour détecter les changements inattendus.
Branches
Branch
qwen3.5Une ligne de travail nommée qui peut se déplacer indépendamment des autres lignes de travail.
Les branches vous permettent de développer une fonctionnalité sans modifier immédiatement la branche principale.
qwen3.5Indiquez-moi sur quelle branche je suis actuellement.
Branches
main branch
mainLa branche par défaut qui représente généralement la version stable ou prête pour la production.
Comparez votre branche de travail avec la branche principale pour voir ce qui a changé.
mainComparer cette branche avec la branche principale.
Branches
checkout
git switch qwen3.5Modifier l'arborescence de travail pour passer à une autre branche ou à un autre commit.
Utilisez-le lorsque vous devez examiner ou continuer à travailler sur une autre branche.
Les modifications non validées peuvent bloquer le changement de branche si elles seraient écrasées.
git switch qwen3.5Basculez vers la branche qwen3.5 après avoir vérifié l'absence de modifications non validées.
Branches
merge
git merge mainCombiner les modifications d'une branche dans une autre branche.
Utilisez la commande "merge" pour intégrer les mises à jour principales dans votre branche de fonctionnalité ou pour finaliser une fonctionnalité dans la branche principale.
La fusion peut créer des conflits lorsque les deux branches ont modifié les mêmes lignes de manière différente.
git merge mainExpliquer ce qui se passerait avant de fusionner main dans cette branche.
Branches
rebase
git rebase mainRejouer les commits d'une branche par rapport à un autre commit de base.
Cela peut faire paraître l'historique linéaire avant de fusionner une branche de fonctionnalité.
Une réinitialisation modifie l'historique des modifications, elle doit donc être utilisée avec précaution sur les branches partagées.
git rebase mainNe faites pas de rebase pour le moment. Expliquez d'abord le risque sur cette branche.
Synchronisation
clone
git clone https://github.com/user/project.gitCréer une copie locale d'un dépôt distant.
Il s'agit généralement de la première étape lors du démarrage d'un projet GitHub existant.
git clone https://github.com/user/project.gitCloner ce dépôt et afficher les branches disponibles.
Synchronisation
remote
origine git@github.com:user/project.gitUne connexion nommée du dépôt local vers un dépôt hébergé ailleurs.
Les paramètres distants déterminent où les opérations de pull et push communiquent.
origine git@github.com:user/project.gitAfficher les dépôts configurés.
Synchronisation
fetch
git fetch originTéléchargement des informations de la branche distante sans modifier vos fichiers de travail.
Utilisez la fonction "fetch" avant de comparer votre branche avec l'état le plus récent du dépôt distant.
git fetch originRécupérer à partir de l'origine, puis comparer cette branche avec main.
Synchronisation
pull
git pull origin mainRécupérer les modifications distantes et les appliquer à la branche actuelle.
Utilisez-le pour mettre à jour votre branche locale avec les modifications qui ont été poussées ailleurs.
Une demande de modification peut modifier votre branche de travail et peut provoquer des conflits.
git pull origin mainAvant de télécharger, vérifiez si j'ai des modifications locales non validées.
Synchronisation
push
git push origin qwen3.5Télécharger les commits locaux vers un dépôt distant.
Une demande de modification permet de rendre vos modifications locales disponibles sur GitHub ou un autre dépôt distant.
Une demande de modification ne télécharge que les modifications, et non les modifications non enregistrées de l'arborescence de travail.
git push origin qwen3.5Effectuer une demande de modification de la branche actuelle après avoir confirmé que la compilation réussit.
Synchronisation
origin
git push origin qwen3.5Le nom par défaut conventionnel pour le dépôt distant à partir duquel vous avez cloné.
La plupart des exemples de "push", "pull" et "fetch" utilisent "origin" comme nom de l'entité distante.
git push origin qwen3.5Vérifiez si l'origine pointe vers le dépôt GitHub attendu.
Revue
Pull Request
Ouvrir une demande de modification PR depuis qwen3.5 vers mainUne page de révision GitHub pour discuter et fusionner les modifications de branche.
Utilisez une demande de tirage PR pour examiner les fichiers modifiés, exécuter des vérifications, discuter des commentaires et fusionner en toute sécurité.
Ouvrir une demande de modification PR depuis qwen3.5 vers mainRésumez ce qui doit figurer dans la description de la PR.
Revue
Review
Examiner les modifications demandéesVérification des modifications de code pour détecter les bogues, les régressions, la lisibilité et les tests manquants.
L'examen permet de détecter les problèmes avant de fusionner une branche dans le code source partagé.
Examiner les modifications demandéesExaminer cette branche pour détecter les bogues et les tests manquants.
Conflits
Merge conflict
CONFLICT (content): Conflit de fusion dans src/app/page.tsxUne situation où Git ne peut pas combiner automatiquement les modifications provenant de différentes branches.
Vous devez choisir le contenu final correct avant que la fusion puisse continuer.
Ne prenez pas position sans vérifier le comportement attendu.
CONFLICT (content): Conflit de fusion dans src/app/page.tsxExpliquer le conflit et proposer la résolution la plus sûre.
Conflits
Conflict marker
<<<<<<< HEADLes marqueurs de texte que Git insère dans un fichier pour afficher les versions en conflit.
Les marqueurs indiquent quelle partie provient de votre branche actuelle et quelle partie provient de la branche entrante.
Les marqueurs de conflit ne doivent pas rester dans le code validé.
<<<<<<< HEADRechercher tous les marqueurs de conflit restants.
Conflits
Untracked file
?? src/lib/git-github.tsUn fichier qui existe dans le dossier mais qui n'a pas encore été ajouté au suivi Git.
Les nouvelles pages et composants apparaissent généralement comme non suivis jusqu'à ce qu'ils soient mis en scène.
?? src/lib/git-github.tsLister les fichiers non suivis et me dire à quels fichiers appartiennent cette fonctionnalité.
Conflits
Modified file
M src/components/SiteHeader.tsxUn fichier suivi dont le contenu diffère de la dernière version commitée.
Cela vous aide à voir quels fichiers existants ont été modifiés par le travail actuel.
M src/components/SiteHeader.tsxAfficher les fichiers modifiés pour cette tâche.
Sécurité
stash
git stash push -m "before branch switch"Enregistre temporairement les modifications non validées afin que l'arborescence de travail puisse être nettoyée.
Utilisez "stash" avant de changer de branche lorsque vous n'êtes pas prêt à valider.
Le travail mis en attente peut être oublié. Nommez-le toujours clairement et réappliquez-le délibérément.
git stash push -m "before branch switch"Mettre en attente mes modifications actuelles avec un message clair avant de basculer vers d'autres branches.
Sécurité
reset
git reset --soft HEAD~1Déplacer une branche ou un état de test vers un autre commit ou état.
Un réinitialisation souple ou mixte peut ajuster un commit local avant qu'il ne soit partagé.
Un réinitialisation complète peut supprimer des données. Demandez une explication avant de l'utiliser.
git reset --soft HEAD~1Expliquer la façon la plus sûre d'annuler le dernier commit local sans perdre les modifications.
Sécurité
revert
git revert abc1234Création d'un nouveau commit qui annule un commit précédent.
L'opération "Revert" est généralement plus sûre que la réécriture de l'historique après que les commits ont été poussés.
git revert abc1234Annuler le commit problématique sans réécrire l'historique partagé.
Sécurité
force push
git push --force-with-lease origin qwen3.5Remplacement d'une branche distante par l'historique de votre branche locale.
Il est parfois utilisé après avoir réécrit l'historique local sur une branche de fonctionnalité privée.
Force push peut effacer les commits distants d'autres personnes. Préférez force-with-lease et confirmez d'abord.
git push --force-with-lease origin qwen3.5N'utilisez pas la commande "force push". Expliquez si une "force-with-lease" est nécessaire.
Sécurité
.gitignore
Répertoire .next/Un fichier qui indique à Git quels fichiers ou dossiers ne doivent pas être suivis.
Utilisez-le pour les sorties de construction, les dépendances, les fichiers d'environnement locaux et les fichiers temporaires.
Répertoire .next/Vérifiez si la sortie de la compilation est correctement ignorée.
Commandes
git status
git status --shortUne commande qui affiche la branche, les modifications préparées, les fichiers modifiés et les fichiers non suivis.
L'exécuter avant la modification, la validation, la récupération ou le changement de branche.
git status --shortExécuter git status et résumer uniquement les modifications importantes.
Commandes
git log
git log --oneline -5Une commande pour afficher l'historique des commits.
Utilisez-le pour trouver les commits récents, comparer le travail ou identifier un commit à annuler.
git log --oneline -5Afficher les cinq derniers commits dans un format compact.
Commandes
git add
git add src/lib/git-github.tsUne commande qui prépare les modifications pour le prochain commit.
Utilisez des chemins explicites lorsque vous souhaitez effectuer un commit ciblé.
git add src/lib/git-github.tsAjouter uniquement les fichiers créés pour cette page.
Commandes
git commit
git commit -m "Add Git terms reference"Une commande qui enregistre les modifications préparées dans l'historique du dépôt.
Utilisez un message qui indique ce qui a changé et pourquoi cela compte.
git commit -m "Add Git terms reference"Valider les modifications préparées avec un message clair.
Commandes
git pull
git pull --ff-onlyUne commande qui met à jour la branche actuelle à partir d'une branche distante.
L'option --ff-only évite la création d'un commit de fusion inattendu.
git pull --ff-onlyEffectuer une demande de modification avec ff-only si cela est sûr.
Commandes
git push
git push origin HEADUne commande qui télécharge les commits locaux vers une branche distante.
Utilisez-le après que les tests ont réussi et que les commits sont prêts à être partagés.
git push origin HEADEffectuer une demande de modification de cette branche après avoir confirmé qu'il n'y a pas d'erreurs de lint ou de compilation.