Paramètres et préférences Git dans Visual Studio

Dans Visual Studio, vous pouvez configurer et afficher les paramètres et préférences Git courants, tels que votre nom et votre adresse e-mail, vos outils de différences et de fusion préférés, etc. Ces paramètres et préférences peuvent être affichés et configurés dans la boîte de dialogue Options de la page Paramètres globaux Git (s’applique à tous vos référentiels) ou dans la page Paramètres du référentiel Git (s’applique au référentiel actif).

Vous pouvez configurer deux types de paramètres :

• Paramètres Git : les paramètres de cette section correspondent aux paramètres Git enregistrés dans les fichiers de configuration Git. Ces paramètres peuvent être affichés et modifiés dans Visual Studio, mais sont gérés par des fichiers de configuration Git.
• Paramètres de Visual Studio : les paramètres de cette section configurent les paramètres et préférences liés à Git gérés par Visual Studio.

Guide pratique pour configurer les paramètres

1. Pour configurer les paramètres Git dans Visual Studio, choisissez Paramètres dans le menu Git de niveau supérieur.

   

2. Choisissez Les paramètres globaux Git ou les paramètres de dépôt Git pour afficher et configurer les paramètres au niveau global ou au niveau du référentiel.

   

3. Vous pouvez configurer plusieurs paramètres Git courants, comme décrit dans les sections suivantes de cet article. Après avoir configuré vos paramètres souhaités, sélectionnez OK pour enregistrer les paramètres mis à jour.

   

Paramètres Git

Vous pouvez également configurer et vérifier certains des paramètres de configuration Git les plus courants. Vous pouvez afficher et modifier les paramètres suivants dans Visual Studio, même s’ils sont gérés par des fichiers de configuration Git.

• Nom et e-mail
• Supprimer des branches distantes lors de l'extraction
• Rebaser la branche locale lors de l’extraction
• Fournisseur de réseau de chiffrement
• Assistant d'authentification
• Outils de Diff & merge
• Fichiers Git
• Télécommandes
• Autres paramètres

Nom et e-mail

Le nom et l’e-mail que vous fournissez sont utilisés comme informations de commiteur pour toute validation que vous effectuez. Ce paramètre est disponible aussi bien dans les étendues globales que de référentiel, et correspond aux paramètres git config et user.email.

1. Dans le menu Git, accédez à Paramètres. Pour définir votre nom d’utilisateur et votre adresse e-mail au niveau global, accédez aux paramètres globaux Git ; pour définir votre nom d’utilisateur et votre e-mail au niveau du référentiel, accédez aux paramètres du référentiel Git.

2. Indiquez votre nom d’utilisateur et votre adresse e-mail, puis choisissez OK à enregistrer.

   

Supprimer les branches distantes lors du rapatriement

Le nettoyage supprime les branches de suivi distant qui n'existent plus sur le dépôt distant et vous aide à maintenir la liste des branches propre et à jour. Ce paramètre est disponible à la fois dans les étendues globales et de référentiel, et correspond au git config paramètre fetch.prune.

Nous vous recommandons de définir cette option sur True au niveau global. Les paramètres valides sont les suivants :

• True (recommandé)
• Faux
• Non défini (valeur par défaut)

Voici comment modifier les paramètres :

1. Dans le menu Git, accédez à Paramètres. Accédez à Paramètres globaux Git pour configurer cette option au niveau global ; accédez aux paramètres du référentiel Git pour configurer cette option au niveau du dépôt.

2. Définissez Les branches distantes Prune pendant la récupération sur True (recommandé). Sélectionnez Ok pour enregistrer.

   

Rebaser la branche locale lors de l’extraction

Le rebasage met de côté les modifications apportées par des commits dans la branche actuelle qui ne se trouvent pas dans la branche en amont, réinitialise la branche actuelle pour qu'elle soit identique à la branche en amont, puis applique les modifications qui ont été mises de côté. Ce paramètre est disponible à la fois dans les étendues globales et de référentiel, et correspond au git config paramètre pull.rebase. Les paramètres valides sont les suivants :

• True : Rebaser la branche actuelle au-dessus de la branche en amont après l’extraction.

• False : fusionnez la branche actuelle dans la branche en amont.

• Unset (valeur par défaut) : sauf indication dans d’autres fichiers de configuration, fusionnez la branche actuelle dans la branche en amont.

• Interactive : Rebase en mode interactif.

• Fusions : Rebasez sans supprimer les commits de fusion créés localement.

  Remarque

  Dans Visual Studio 2022 version 17.2, nous avons modifié le paramètre « Conserver » en « Fusions » pour qu’il corresponde à une mise à jour récente de Git. Par conséquent, si vous utilisez une version antérieure de Visual Studio avec des outils Git, votre interface utilisateur peut dire « Conserver » au lieu de « Fusionner ». Toutefois, la fonctionnalité reste la même.

Voici comment modifier les paramètres :

1. Dans le menu Git, accédez à Paramètres. Accédez à Paramètres globaux Git pour configurer cette option au niveau global ; accédez aux paramètres du référentiel Git pour configurer cette option au niveau du dépôt.

2. Définissez le paramètre souhaité de rebasage de la branche locale lors de l’extraction, puis sélectionnez OK pour enregistrer.

   

Il n’est pas possible de configurer pull.rebase sur Interactive dans Visual Studio. Visual Studio ne prend pas en charge la rebase interactive. Pour configurer pull.rebase l’utilisation du mode interactif, utilisez la ligne de commande.

Fournisseur de réseau de chiffrement

Le fournisseur de réseau de chiffrement est un paramètre de configuration Git dans l’étendue globale qui configure le serveur principal TLS/SSL à utiliser au moment de l’exécution et correspond au git config paramètre http.sslBackend. Les valeurs sont les suivantes :

• OpenSSL : Utilisez OpenSSL pour les protocoles TLS et SSL.
• Canal sécurisé : utilisez un canal sécurisé (schannel) pour les protocoles TLS et SSL. Schannel est la solution Windows native, accédant au Windows Credential Store, ce qui permet une gestion à l’échelle de l’entreprise des certificats.
• Non défini (par défaut) : si ce paramètre n’est pas défini, OpenSSL est par défaut.

Voici comment modifier les paramètres :

1. Dans le menu Git, accédez à Paramètres. Accédez à Paramètres globaux Git pour configurer ce paramètre.

2. Définissez le fournisseur de réseau de chiffrement sur la valeur souhaitée, puis sélectionnez OK pour enregistrer.

   

Assistant de gestion des identifiants

Lorsque Visual Studio effectue une opération Git distante, le point de terminaison distant peut rejeter la demande, car il nécessite des informations d’identification à fournir à la demande. À ce stade, Git appelle un assistant de gestionnaire d'informations d'identification, qui fournit les identifiants nécessaires pour effectuer l'opération, et essaie à nouveau d'envoyer la requête. L’assistant d’authentification utilisé correspond au git config paramètre credential.helper. Elle est disponible dans le contexte global avec les valeurs suivantes :

• GCM pour Windows : Utilisez Le Gestionnaire d’informations d’identification Git pour Windows comme assistance.
• GCM Core : Utilisez Git Credential Manager Core comme assistance.
• Non défini (valeur par défaut) : Si ce paramètre n'est pas défini, l'assistant d'identification défini dans la configuration système est utilisé. À partir de Git pour Windows 2.29, le gestionnaire d'informations d'identification par défaut est GCM Core.

Voici comment modifier les paramètres :

1. Dans le menu Git, accédez à Paramètres. Accédez à Paramètres globaux Git pour configurer ce paramètre.

2. Définissez l’assistance d’informations d’identification sur la valeur souhaitée, puis sélectionnez OK pour enregistrer.

   

Outils de comparaison et de fusion

Git affiche les différences et les conflits de fusion dans vos outils préférés. Les paramètres de cette section correspondent aux git config paramètres diff.tool et merge.tool. Vous pouvez configurer Git pour utiliser Visual Studio comme outil de fusion ou de différences dans les paramètres globaux Git et les paramètres du dépôt Git en sélectionnant Utiliser Visual Studio. Pour configurer d'autres commandes de diff et de fusion, activez git config avec l'option diff.tool ou merge.tool.

Fichiers Git

Vous pouvez utiliser la section Fichiers Git dans l’étendue Paramètres du référentiel Git pour afficher et modifier les fichiers gitignore et gitattributes pour votre référentiel.

Référentiels distants

Vous pouvez utiliser le volet Remotes sous Paramètres du référentiel Git pour configurer les distances de votre référentiel. Ce paramètre correspond à la commande git remote et vous permet d’ajouter, de modifier ou de supprimer des dépôts distants.

Autres paramètres

Pour afficher tous vos autres paramètres de configuration Git, vous pouvez ouvrir et afficher les fichiers de configuration eux-mêmes, ou vous pouvez l’exécuter git config --list pour afficher les paramètres.

Paramètres de Visual Studio

Les paramètres suivants gèrent les préférences liées à Git dans Visual Studio et sont gérés par Visual Studio au lieu de fichiers de configuration Git. Tous les paramètres de cette section sont configurés dans la page Paramètres globaux Git .

Emplacement par défaut

L’emplacement par défaut configure le dossier par défaut dans lequel les référentiels sont clonés.

Fermer les solutions ouvertes non sous Git lors de l’ouverture d’un référentiel

Par défaut, Visual Studio ferme toute solution ou dossier ouvert lorsque vous basculez vers un autre référentiel. Dans ce cas, il peut également charger la solution ou le dossier du nouveau référentiel en fonction de si vous choisissez d’ouvrir un dossier dans l’Explorateur de solutions lors de l’ouverture d’un dépôt Git et charger automatiquement la solution lors de l’ouverture d’un dépôt Git. Ce paramètre maintient la cohérence entre le code ouvert et le référentiel ouvert. Toutefois, si votre solution n’est pas dans la même racine de dossier que votre référentiel, vous pouvez conserver la solution ouverte lorsque vous basculez vers son référentiel. Vous pouvez le faire avec ce paramètre. Les valeurs sont les suivantes :

• Oui : Lorsqu’un référentiel est ouvert, la solution actuellement ouverte est toujours fermée

• Non : lorsqu’un référentiel est ouvert, Visual Studio effectue une vérification quant à savoir si la solution actuelle se trouve sous Git. Si ce n’est pas le cas, la solution reste ouverte.

• Demandez toujours (valeur par défaut) : lorsque cela est défini, vous pouvez effectuer un choix via une boîte de dialogue par dépôt ouvert, que vous souhaitiez conserver la solution actuelle ouverte ou la fermer.

  

Activer le téléchargement d’images d’auteur à partir de sources tierces

Activer le téléchargement d’images d’auteur à partir de sources tierces est un paramètre spécifique à Visual Studio à l’étendue globale. Une fois cochées, les images d’auteur sont téléchargées à partir du service d’images Gravatar, le cas échéant, et affichées dans les vues de validation et d’historique.

Valider les modifications après fusion par défaut

Lorsque la validation des modifications après la fusion par défaut est activée, Git crée automatiquement une validation lorsqu’une branche est fusionnée avec la branche actuelle.

• Lorsque cette option est activée, git merge les commandes émises par Visual Studio sont exécutées avec l’option --commit .
• Lorsqu’elles sont désactivées, git merge les commandes émises par Visual Studio sont exécutées avec les --no-commit --no-ff options.

Pour plus d’informations sur ces options, consultez --commit et --no-commit et --no-ff.

Activer la commande push --force-with-lease

Lorsqu'il est activé, ce paramètre vous permet de push --force-with-lease dans Visual Studio. Par défaut, l'activation de push --force-with-lease est désactivée.

Pour plus d’informations, consultez push --force-with-lease.

Ouvrir un dossier dans l’Explorateur de solutions lors de l’ouverture d’un référentiel Git

Lorsque vous utilisez Visual Studio pour ouvrir ou basculer vers un dépôt Git, Visual Studio charge le contenu Git afin de pouvoir afficher les modifications, les validations, les branches et gérer votre référentiel à partir de l’IDE. En outre, Visual Studio charge également le code du référentiel dans l’Explorateur de solutions. Visual Studio analyse le dossier de référentiel pour les solutions, les CMakeLists.txt, ou tout autre fichier d’affichage qu’il reconnaît et les affiche sous forme de liste dans l’Explorateur de solutions. À partir de là, vous pouvez sélectionner une solution à charger ou un dossier pour afficher le contenu du répertoire. Lorsque vous désactivez cette case à cocher, Visual Studio n’ouvre pas le dossier du référentiel dans l’Explorateur de solutions. Cette option vous permet essentiellement d’ouvrir Visual Studio en tant que gestionnaire de référentiel Git uniquement. Le paramètre est activé par défaut.

Charger automatiquement la solution lors de l’ouverture d’un référentiel Git

Ce paramètre s’applique uniquement lorsque le dossier Ouvrir dans l’Explorateur de solutions lors de l’ouverture d’un paramètre de référentiel Git est activé. Lorsque vous ouvrez un dépôt Git dans Visual Studio et que l’analyse de dossier suivante détecte qu’il n’existe qu’une seule solution dans votre référentiel, Visual Studio charge automatiquement cette solution. Si vous désactivez le paramètre, l’Explorateur de solutions affiche la solution unique présente dans le référentiel dans la liste des vues. Mais il ne charge pas la solution. Par défaut, ce paramètre est désactivé.

Extraire automatiquement les branches avec double-clic ou la touche Entrée

La fenêtre Référentiel Git contient une liste de branches affichées dans une arborescence. La sélection unique d’une branche change le volet d’historique des validations pour afficher les validations pour la branche sélectionnée. Pour vérifier une branche, vous pouvez cliquer avec le bouton droit pour ouvrir le menu contextuel et sélectionner Vérifier. Si vous activez ce paramètre, un double-clic ou une pression sur la touche Entrée vérifie la branche et affiche ses validations.

Contenu connexe

• Prise en main de Git dans Visual Studio vidéo sur YouTube
• Productivité améliorée avec Git dans Visual Studio article de blog
• Boîte de dialogue Options