Git

Git nella barra del pannello#

Quando un pannello si trova in un repository, la sua barra superiore mostra il branch corrente, quanti commit sono avanti (↑) e indietro (↓) e quanti file sono cambiati. Accanto trovi:

Nome del branch

Apre l’elenco dei branch: prima quelli locali, poi quelli solo remoti. Fai clic su un branch (o premi Invio) per passarci. Digita un nome che non esiste e premi Invio per creare il branch e passarci. I branch già estratti in un altro worktree sono contrassegnati e non si possono scegliere.

Diff

Apre le modifiche non committate della cartella di questo pannello, senza aprire la finestra Git.

Worktree

Crea un worktree per questo repository. Vedi Worktree.

Commit

Apre lo stato dei file della finestra Git con il cursore nel campo del messaggio.

Fetch / Pull / Push

Pull è evidenziato quando c’è qualcosa da scaricare. Senza upstream, esegue il pull dal branch predefinito del remoto (ad es. origin/main); il suggerimento indica la sorgente. Push compare quando hai commit non ancora inviati.

La finestra Git#

Fai clic su Git nella barra degli strumenti o premi Cmd/Ctrl+E per aprire la finestra Git del repository del terminale attivo. Il badge nella barra degli strumenti mostra quanti file sono cambiati. Chiudila con Esc, con il pulsante × o di nuovo con Cmd/Ctrl+E. Trascina i bordi per ridimensionarla; fai doppio clic su una maniglia per ripristinarla.

La parte sinistra passa tra Stato dei file, Cronologia, Cerca, worktree, issue e pull request, ed elenca Branch (raggruppati in cartelle in base a /), Remoti e Tag. Fai clic su un ref per mostrarne il commit nella cronologia; fai doppio clic su un branch per fare il checkout.

Rivedere e committare le modifiche#

1. Apri la finestra Git. Si apre su Stato dei file, che elenca ogni file non committato con il suo stato e il numero di righe.
2. Fai clic su un file per vederne il diff con i numeri di riga. Togli la spunta ai file che non vuoi in questo commit.
3. Scrivi un messaggio in Messaggio del commit. Spunta Esegui il push dopo il commit per inviare subito.
4. Premi Commit o Cmd/Ctrl+Enter.

Tutte le modifiche apre il diff completo dell’albero di lavoro in un visualizzatore più grande. Lì le righe lunghe vanno a capo e puoi trascinare il bordo dell’elenco dei file per allargarlo.

Sfogliare la cronologia#

Cronologia disegna un grafo dei commit su tutti i branch e tag locali e remoti. Seleziona un commit per vederne i file e la patch sotto. Cerca filtra per messaggio, autore o hash.

Clic destro su un commit → Torna a questo commit... riporta il branch a quel commit. I commit successivi escono dalla cronologia corrente e le modifiche non committate ai file tracciati vengono scartate (i file non tracciati restano), quindi ti viene chiesta prima una conferma.

Pull, push, fetch e stash#

Pull

Scegli quale branch remoto scaricare in quello corrente, senza cambiare branch.

Push

Invia il branch corrente e ne imposta l’upstream al primo push.

Fetch

Scarica gli aggiornamenti da tutti i remoti.

Stash

Mette da parte le modifiche, compresi i file non tracciati (git stash push -u).

Quando Git non può essere eseguito#

Se il tuo computer impedisce a git di funzionare, PATerminal spiega il motivo e mostra la correzione in una riga, con Scrivi nel terminale per inserirla (Invio lo premi tu) oppure Copia. Riconosce una licenza di Xcode non accettata, Command Line Tools mancanti, Git non installato, una cartella di proprietà di un altro utente (“dubious ownership”) e i limiti di lunghezza dei percorsi di Windows.