Setup and Config
Getting and Creating Projects
Basic Snapshotting
Branching and Merging
Sharing and Updating Projects
Inspection and Comparison
Patching
Debugging
External Systems
Server Admin
Guides
- gitattributes
- Command-line interface conventions
- Everyday Git
- Frequently Asked Questions (FAQ)
- Glossary
- Hooks
- gitignore
- gitmodules
- Revisions
- Submodules
- Tutorial
- Workflows
- All guides...
Administration
Plumbing Commands
- 2.53.0 no changes
-
2.52.0
2025-11-17
- 2.51.2 no changes
-
2.51.1
2025-10-15
- 2.50.1 → 2.51.0 no changes
-
2.50.0
2025-06-16
- 2.45.1 → 2.49.1 no changes
-
2.45.0
2024-04-29
- 2.43.1 → 2.44.4 no changes
-
2.43.0
2023-11-20
- 2.41.1 → 2.42.4 no changes
-
2.41.0
2023-06-01
- 2.38.3 → 2.40.4 no changes
-
2.38.2
2022-12-11
- 2.38.1 no changes
-
2.38.0
2022-10-02
- 2.37.1 → 2.37.7 no changes
-
2.37.0
2022-06-27
- 2.31.1 → 2.36.6 no changes
-
2.31.0
2021-03-15
- 2.22.1 → 2.30.9 no changes
-
2.22.0
2019-06-07
- 2.20.1 → 2.21.4 no changes
-
2.20.0
2018-12-09
- 2.12.5 → 2.19.6 no changes
-
2.11.4
2017-09-22
- 2.2.3 → 2.10.5 no changes
-
2.1.4
2014-12-17
-
2.0.5
2014-12-17
NOM
git-mergetool - Lancer les outils de résolution de conflit de fusion pour résoudre les conflits de fusion
DESCRIPTION
Utilisez git mergetool pour lancer l’un des nombreux utilitaires de fusion afin de résoudre les conflits de fusion. Il est généralement lancé après git merge.
Si un ou plusieurs paramètres <fichier> sont donnés, le programme outil de fusion sera exécuté pour résoudre les différences dans chaque fichier (en sautant ceux qui n’ont pas de conflit). La spécification d’un répertoire inclura tous les fichiers non résolus dans ce chemin. Si aucun nom de <fichier> n’est spécifié, git mergetool lancera le programme de fusion sur chaque fichier ayant des conflits de fusion.
OPTIONS
-
-t<outil> -
--tool=<outil> -
Utiliser le programme de résolution de fusion spécifié par <outil>. Les valeurs valides comprennent
emerge,gvimdiff,kdiff3,meld,vimdiffettortoisemerge. Lancezgitmergetool--tool-helppour obtenir la liste des paramètres <outil> valides.Si un programme de résolution de fusion n’est pas spécifié,
gitmergetoolutilisera la variable de configurationmerge.tool. Si la variable de configurationmerge.tooln’est pas définie,gitmergetoolchoisira une valeur par défaut appropriée.Vous pouvez explicitement fournir un chemin complet vers l’outil en définissant la variable de configuration
mergetool.<outil>.path. Par exemple, vous pouvez configurer le chemin absolu vers kdiff3 en définissantmergetool.kdiff3.path. Sinon,gitmergetoolsuppose que l’outil est disponible dans$PATH.Au lieu d’exécuter un des programmes connus de l’outil de fusion,
gitmergetoolpeut être personnalisé pour exécuter un programme alternatif en spécifiant la ligne de commande à invoquer dans une variable de configurationmergetool.<outil>.cmd.Lorsque
gitmergetoolest invoqué avec cet outil (soit par l’option-tou--toolou par la variable de configurationmerge.tool), la ligne de commande configurée sera invoquée avecBASEdéfini au nom d’un fichier temporaire contenant la base commune pour la fusion, si disponible ;LOCALdéfini au nom d’un fichier temporaire contenant le contenu du fichier sur la branche courante ;REMOTEdéfini au nom d’un fichier temporaire contenant le contenu du fichier à fusionner, etMERGEDdéfini au nom du fichier dans lequel l’outil de fusion doit écrire le résultat de la résolution de la fusion.Si l’outil de fusion personnalisé indique correctement le succès d’une résolution de fusion dans son code de sortie, alors la variable de configuration
mergetool.<outil>.trustExitCodepeut être définie àtrue. Sinon,gitmergetooldemandera à l’utilisateur d’indiquer le succès de la résolution après que l’outil personnalisé soit sorti. -
--tool-help -
Afficher une liste des outils de fusion utilisables avec
--tool. -
-y -
--no-prompt -
Ne pas demander avant chaque invocation du programme de résolution de fusion. C’est la valeur par défaut si le programme de résolution de fusion est explicitement spécifié avec l’option
--toolou avec la variable de configurationmerge.tool. -
--prompt -
Demander avant chaque invocation du programme de résolution de fusion pour donner à l’utilisateur une chance de sauter le chemin.
-
-g -
--gui -
Lorsque
git-mergetoolest invoqué avec l’option-gou--gui, l’outil de fusion par défaut sera lu à partir de la variablemerge.guitoolconfigurée au lieu demerge.tool. Simerge.guitooln’est pas défini, l’outil configuré sousmerge.toolest utilisé. L’outil graphique peut être autosélectionné en utilisant la variable de configurationmergetool.guiDefault. -
--no-gui -
Ceci prend le pas sur un réglage précédent de
-gou--guiou la configurationmergetool.guiDefaultet lit que l’outil de fusion par défaut à partir de la variablemerge.toolconfigurée. -
-O<fichier-d-ordre> -
Traiter les fichiers dans l’ordre spécifié dans le <fichier d’ordre>, qui a un motif glob shell par ligne. Ceci remplace la variable de configuration
diff.orderFile(voir git-config[1]). Pour annulerdiff.orderFile, utilisez-O/dev/null.
CONFIGURATION
Tout ce qui se trouve en dessous de cette ligne dans cette section est inclus de manière sélective à partir de la documentation git-config[1]. Le contenu est le même que celui qui s’y trouve :
-
mergetool.<outil>.path -
Surcharger le chemin pour l’outil donné. Ceci est utile si votre outil n’est pas dans le
$PATH. -
mergetool.<outil>.cmd -
Spécifier la commande pour invoquer l’outil de fusion spécifié. La commande spécifiée est évaluée dans un shell avec les variables suivantes disponibles :
BASEest le nom d’un fichier temporaire contenant la base commune des fichiers à fusionner, si disponible ;LOCALest le nom d’un fichier temporaire contenant le contenu du fichier sur la branche actuelle ;REMOTEest le nom d’un fichier temporaire contenant le contenu du fichier de la branche à fusionner ;MERGEDcontient le nom du fichier dans lequel l’outil de fusion devra écrire le résultat d’une fusion réussie. -
mergetool.<outil>.hideResolved -
Permet à l’utilisateur de remplacer la valeur globale de
mergetool.hideResolvedpour un outil spécifique. Voirmergetool.hideResolvedpour la description complète. -
mergetool.<outil>.trustExitCode -
Pour une commande de fusion personnalisée, spécifier si le code de sortie de la commande de fusion peut être utilisé pour déterminer si la fusion a été réussie. Si cela n’est pas réglé à true alors l’horodatage du fichier cible de fusion est vérifié, et la fusion est supposée avoir été réussie si le fichier a été mis à jour ; sinon, l’utilisateur est invité à indiquer le succès de la fusion.
-
mergetool.meld.hasOutput -
Les versions plus anciennes de
meldne gèrent pas l’option--output. Git tentera de déterminer simeldgère--outputen inspectant la sortie demeld--help. Configurermergetool.meld.hasOutputindiquera à Git de sauter ces vérifications et utilisera la valeur configurée à la place. Réglermergetool.meld.hasOutputàtrueindique à Git d’utiliser inconditionnellement l’option--outputetfalseévite d’utiliser--output. -
mergetool.meld.useAutoMerge -
Lorsque l’option
--auto-mergeest donnée, meld fusionnera automatiquement toutes les parties non conflictuelles, mettra en évidence les parties en conflit et attendra la décision de l’utilisateur. Réglermergetool.meld.useAutoMergeàtrueindique à Git d’utiliser sans condition l’option--auto-mergeavecmeld. Régler cette valeur àautopermet de détecter si--auto-mergeest pris en charge et n’utilisera que l’option--auto-mergelorsqu’elle est disponible. Une valeur àfalseévite complètement d’utiliser--auto-mergeet c’est la valeur par défaut. -
mergetool.<variante>.layout -
Configurer la configuration en fenêtre scindée pour la <variante> de vimdiff, parmi
vimdiff,nvimdiff,gvimdiff. Lors du lancement degitmergetoolavec--tool=<variante> (ou sans--toolsimerge.toolest configuré comme <variante>), Git consulteramergetool.<variante>.layoutpour déterminer la disposition de l’outil. Si la configuration spécifique à la variante n’est pas disponible, celle devimdiffest utilisée par défaut. Si elle n’est pas non plus disponible, une mise en page par défaut avec 4 fenêtres sera utilisée. Pour configurer la mise en page, voir le INDICES SPÉCIFIQUES À UN BACKEND section. -
mergetool.hideResolved -
Lors d’une fusion, Git résoudra automatiquement le plus de conflits possible et écrira le fichier
$MERGEDcontenant des marqueurs de conflit autour de tout conflit qu’il ne peut résoudre ;$LOCALet$REMOTEsont normalement les versions du fichier avant la résolution de conflit de Git. Ce drapeau provoque l’écrasement de$LOCALet$REMOTEafin que seuls les conflits non résolus soient présentés à l’outil de fusion. Peut être configuré par outil via la variable de configurationmergetool.<outil>.hideResolved. Par défaut àfalse. -
mergetool.keepBackup -
Après avoir effectué une fusion, le fichier original avec des marqueurs de conflit peut être enregistré comme fichier avec une extension
.orig. Si cette variable est définie àfalsealors ce fichier n’est pas conservé. Par défaut àtrue(c.-à-d. garder les fichiers de sauvegarde). -
mergetool.keepTemporaries -
Lorsque vous invoquez un outil de fusion personnalisé, Git utilise un ensemble de fichiers temporaires qu’il passe à l’outil. Si l’outil retourne une erreur et que cette variable est définie à
true, alors ces fichiers temporaires seront conservés ; sinon, ils seront supprimés après la sortie de l’outil. Par défaut àfalse. -
mergetool.writeToTemp -
Git écrit des versions temporaires
BASE,LOCALetREMOTEdes fichiers ayant des conflits dans l’arbre de travail par défaut. Git tentera d’utiliser un répertoire temporaire pour ces fichiers lorsque défini àtrue. Par défaut àfalse. -
mergetool.prompt -
Demander avant chaque invocation du programme de résolution de fusion.
-
mergetool.guiDefault -
Définir à
truepour utilisermerge.guitoolpar défaut (équivalant à spécifier l’argument--gui), ouautopour sélectionnermerge.guitooloumerge.toolselon la présence d`une valeur variable d’environnementDISPLAY. La valeur par défaut estfalse, où l`argument--guidoit être fourni explicitement pour que lemerge.guitoolsoit utilisé.
FICHIERS TEMPORAIRES
git mergetool crée des fichiers de sauvegarde *.orig lors de la résolution des fusions. Il est possible de les supprimer en toute sécurité une fois qu’un fichier a été fusionné et que sa session git mergetool est terminée.
Définir la variable de configuration mergetool.keepBackup sur` false` fait que git mergetool supprime automatiquement les fichiers de sauvegarde lorsque les fichiers sont correctement fusionnés.
GIT
Fait partie de la suite git[1]
TRADUCTION
Cette page de manuel a été traduite par Jean-Noël Avila <jn.avila AT free DOT fr> et les membres du projet git-manpages-l10n. Veuillez signaler toute erreur de traduction par un rapport de bogue sur le site https://github.com/jnavila/git-manpages-l10n .