Git stash: salva le modifiche, cambia ramo e ripristina il tuo lavoro

Git stash salva le modifiche non salvate in modo che tu possa lavorare su qualcos'altro e poi ripristinare tali modifiche. Inizia con git stash push -m "WIP: checkout form"; ripristina con git stash apply quando desideri conservare la voce salvata o git stash pop quando desideri rimuoverla dopo un ripristino riuscito. Aggiungi -u quando all'opera appartengono anche file nuovi e non tracciati.

Questa guida utilizza come esempio un'interruzione del modulo di pagamento: mettere in pausa il modulo, correggere un bug di produzione su un altro ramo, quindi tornare al modulo. La procedura dettagliata visiva utilizza GitTree, il client che creiamo per macOS, Windows e Linux. La gestione della scorta è inclusa nel piano Free; le build ufficiali attuali richiedono l'accesso.

Quando utilizzare stash, un commit o un worktree

Per attività parallele più lunghe, utilizza la guida all'albero di lavoro. Una scorta è un comodo spazio di archiviazione temporaneo, ma non dovrebbe essere l'unico backup di lavoro prezioso. Assegna un nome alle voci dopo l'attività, poiché stash@{0} indica l'ultima voce e i numeri cambiano man mano che l'elenco cambia.

Salvare le modifiche e cambiare ramo: un esempio completo

Innanzitutto controlla git status: una scorta predefinita include le modifiche ai file tracciati, comprese le modifiche graduali, ma lascia intatti i file non tracciati e ignorati. In questo esempio il modulo include un file appena creato, quindi utilizza -u. Questi comandi presuppongono che feature/checkout e hotfix/payment esistano già; sostituisci i nomi delle tue filiali.

git status
git stash push -u -m "WIP: checkout form"
git stash list
git status
git switch hotfix/payment

Completare, testare e confermare l'hotfix prima di ritornare. Controlla l'elenco delle scorte e le relative differenze prima di fare domanda: nel frattempo un'altra attività potrebbe aver creato una voce più recente. Citare un selettore come "stash@{0}" impedisce inoltre alle shell di interpretarne i caratteri speciali.

git switch feature/checkout
git stash list
git stash show -p --include-untracked "stash@{0}"
git stash apply "stash@{0}"
git status

Git stash apply vs pop: quale scegliere?

Per un'importante modifica non completata, applicala prima, rivedila e testala, quindi elimina la voce salvata una volta eseguito il lavoro ripristinato. L'applicazione due volte può creare conflitti o ripetere modifiche; ispezionare i file di lavoro prima di riprovare. Né apply né pop inviano nulla a un server.

Conserva file non tracciati, file specifici o modifiche graduali

git stash push -u -m "WIP: include new files"
git stash push -m "WIP: checkout only" -- src/checkout.ts
git stash push --staged -m "WIP: staged changes only"
git stash push --keep-index -m "WIP: keep staged work ready"

Questi sono comandi alternativi, non una sequenza da eseguire insieme. Un percorso dopo -- limita lo stash a quel percorso. --staged salva solo le modifiche graduali; --keep-index lascia in vigore le modifiche graduali in modo che tu possa testarle o confermarle mentre accantoni altre modifiche. Risolvono diversi problemi. Le installazioni Git precedenti potrebbero non supportare --staged; controlla git --version e la guida per la versione installata.

Vuoi seguire questi passaggi con il tuo repository? Scarica GitTree, accedi e apri la cartella del repository. Le tue scorte esistenti rimangono normali scorte Git, visibili anche dal terminale.

Come risolvere i conflitti git stash pop

Una scorta può entrare in conflitto quando il ramo di destinazione ha modificato le stesse righe. Un pop fallito mantiene la scorta, ma alcune modifiche potrebbero essere già state applicate. Non farlo scoppiare ripetutamente. Esegui git status, risolvi ogni file non unito e metti in scena solo le risoluzioni previste. La guida ai conflitti di unione spiega i marcatori e l'editor a tre vie.

git status
git diff --name-only --diff-filter=U
# Edit and test each conflicted file, then stage its resolution:
git add -- src/checkout.ts
git diff --cached
git status

Non esiste git stash --continue o git stash --abort. Una volta risolti i file, rivedili ed esegui il commit normalmente. Se vuoi abbandonare il tentativo, conserva tutto il lavoro esistente prima dell'applicazione e ispeziona ogni percorso modificato prima di scartare qualsiasi cosa. Un hard reset generale può cancellare le modifiche non correlate. Quando la destinazione si è allontanata troppo, git stash branch rescue/checkout "stash@{0}" si ripristina su un nuovo ramo alla base originale; un'operazione riuscita rimuove quella voce di scorta.

Elimina una scorta solo dopo aver controllato il risultato

Utilizza nuovamente git stash list prima di git stash drop "stash@{0}": la posizione potrebbe essere cambiata. git stash clear rimuove l'intero elenco. Il recupero di una scorta caduta in Git semplice è incerto e dipende dal fatto che i suoi oggetti esistano ancora; non fare affidamento sul trovarlo più tardi. In GitTree, Elimina Stash conserva la voce eliminata negli snapshot di ripristino in modo che Annulla possa ripristinarla. Questo ripristino specifico dell'app non rende l'eliminazione del terminale un'azione recuperabile garantita. Per opzioni di ripristino più ampie, consulta annullamento degli errori Git.