Introduction

posh-git est une extension PowerShell qui intègre les informations d'état Git dans l'invite de commande, permettant une visualisation intuitive et des opérations Git simplifiées. Ce guide technique fournit des méthodes pour diagnostiquer et corriger les anomalies d'affichage de l'état Git.

Vérification de la configuration initiale

Pour valider le chargement du module posh-git, exécutez :

Get-Module -Name posh-git

Si aucun résultat n'appraaît, rechargez le module avec :

Import-Module -Name posh-git

En cas d'erreur, contrôlez la présence du fichier posh-git.psd1 dans le répertoire des modules PowerShell.

Réparation ciblée des dysfonctionnements

Actualisation du cache d'état

Pour forcer la mise à jour de l'état Git, utilisez :

$currentGitState = Get-GitStatus

Si l'anomalie persiste, supprimez le répertoire cache :

Remove-Item -Path "$env:LOCALAPPDATA\posh-git" -Recurse -Force

Analyse des configurations Git

Vérifiez les paramètres Git pouvant impacter l'affichage :

git config --list

Portez une attention particulière aux options comme core.autocrlf et core.filemode. Les mécanismes de gestion sont implémentés dans GitUtils.ps1.

Procédures de dépannage approfondi

Audit de l'intégrité du module

Utilisez PSScriptAnalyzer pour détecter les erreurs potentielles :

Invoke-ScriptAnalyzer -Path "src\posh-git.psm1"

Les scripts de validation correspondants se trouvent dans test/ModuleManifest.Tests.ps1.

Contrôle de compatibilité PowerShell

posh-git requiert PowerShell 5.1 ou supérieur. Vérifiez votre version :

$PSVersionTable.PSVersion

Une mise à jour peut être nécessaire, selon les instructions dans install.ps1.

Activation des logs détaillés

Pour activer le mode débogage :

$GitPromptSettings.Debug = $true

Puis consultez le fichier journal :

Get-Content -Path "$env:TEMP\posh-git-debug.log"

La gestion des logs est définie dans GitPrompt.ps1.

Stratégies de récupération avancée

Réinstallation complète

Si les solutions précédentes échouent, réinstallez le module :

# Désinstallation
Uninstall-Module -Name posh-git -Force

# Installation de la dernière version
Install-Module -Name posh-git -Scope CurrentUser -Force

Exécutez alternatviement le script dédié :

.\install.ps1

Personnalisation manuelle de l'invite

Pour ajuster le format d'affichage, modifiez votre profil PowerShell :

notepad $PROFILE

Adaptez les paramètres $GitPromptSettings en vous basant sur l'exemple fourni dans profile.example.ps1.

Recommandations pour la prévention

• Mettez régulièrement à jour posh-git.
• Exécutez périodiquement les scripts de test dans le répertoire test/.
• Maintenez Git et PowerShell à jour.
• Évitez de modifier les fichiers core tels que posh-git.psm1.