Git

Git dans la barre de volet#

Quand un volet se trouve dans un dépôt, sa barre supérieure affiche la branche actuelle, le nombre de commits en avance (↑) et en retard (↓), et le nombre de fichiers modifiés. À côté :

Nom de la branche

Ouvre la liste des branches : d’abord les branches locales, puis celles qui n’existent que sur le dépôt distant. Cliquez sur une branche (ou appuyez sur Entrée) pour basculer dessus. Tapez un nom qui n’existe pas et appuyez sur Entrée pour créer la branche et y basculer. Les branches extraites dans un autre worktree sont signalées et ne peuvent pas être choisies.

Diff

Ouvre les modifications non commitées du dossier de ce volet, sans ouvrir la fenêtre Git.

Worktree

Crée un worktree pour ce dépôt. Voir Worktrees.

Commit

Ouvre l’état des fichiers de la fenêtre Git, le curseur dans le champ du message.

Fetch / Pull / Push

Pull est mis en évidence quand il y a quelque chose à récupérer. Sans branche amont, il récupère la branche par défaut du dépôt distant (par ex. origin/main) ; l’info-bulle indique la source. Push apparaît quand vous avez des commits non poussés.

La fenêtre Git#

Cliquez sur Git dans la barre d’outils ou appuyez sur Cmd/Ctrl+E pour ouvrir la fenêtre Git du dépôt du terminal actif. Le badge de la barre d’outils indique le nombre de fichiers modifiés. Fermez-la avec Esc, le bouton × ou à nouveau Cmd/Ctrl+E. Faites glisser ses bords pour la redimensionner ; double-cliquez sur une poignée pour la réinitialiser.

La partie gauche bascule entre État des fichiers, Historique, Recherche, les worktrees, les issues et les pull requests, et liste les Branches (regroupées en dossiers selon les /), les Dépôts distants et les Tags. Cliquez sur une référence pour afficher son commit dans l’historique ; double-cliquez sur une branche pour l’extraire.

Relire et commiter les modifications#

1. Ouvrez la fenêtre Git. Elle s’ouvre sur État des fichiers, qui liste chaque fichier non commité avec son état et ses nombres de lignes.
2. Cliquez sur un fichier pour voir son diff avec numéros de ligne. Décochez les fichiers que vous ne voulez pas dans ce commit.
3. Rédigez un message dans Message de commit. Cochez Push après le commit pour pousser immédiatement.
4. Appuyez sur Commit ou Cmd/Ctrl+Enter.

Toutes les modifications ouvre le diff complet de l’arbre de travail dans une visionneuse plus grande. Les lignes longues y passent à la ligne, et vous pouvez faire glisser le bord de la liste des fichiers pour l’élargir.

Parcourir l’historique#

Historique dessine un graphe des commits sur toutes les branches et tags locaux et distants. Sélectionnez un commit pour voir ses fichiers et son patch en dessous. Recherche filtre par message, auteur ou hash.

Clic droit sur un commit → Revenir à ce commit... réinitialise la branche sur ce commit. Les commits ultérieurs quittent l’historique actuel et les modifications non commitées des fichiers suivis sont perdues (les fichiers non suivis restent) : une confirmation vous est donc demandée.

Pull, push, fetch et stash#

Pull

Choisissez la branche distante à récupérer dans la branche actuelle, sans changer de branche.

Push

Pousse la branche actuelle et définit sa branche amont lors du premier push.

Fetch

Récupère les mises à jour de tous les dépôts distants.

Stash

Met les modifications de côté, fichiers non suivis compris (git stash push -u).

Quand Git ne peut pas s’exécuter#

Si votre ordinateur empêche git de fonctionner, PATerminal en indique la raison et affiche le correctif en une ligne, avec Saisir dans le terminal pour l’insérer (vous appuyez sur Entrée) ou Copier. Il reconnaît une licence Xcode non acceptée, des Command Line Tools manquants, Git non installé, un dossier appartenant à un autre utilisateur (« dubious ownership ») et les limites de longueur de chemin de Windows.