diff --git a/README_zh-TW.md b/README_zh-TW.md index 34f22f0..620cc32 100644 --- a/README_zh-TW.md +++ b/README_zh-TW.md @@ -5,100 +5,100 @@ #### 前言 -- 英文原版[README](https://github.com/k88hudson/git-flight-rules/blob/master/README.md) +- 英文原版 [README](https://github.com/k88hudson/git-flight-rules/blob/master/README.md) - 翻譯可能存在錯誤或不標準的地方,歡迎大家指正和修改,謝謝! #### 什麼是"飛行規則"? -這是一篇給太空人(這裡就是指使用Git的程式設計師們)的指南,用來指導問題出現後的應對之法。 +這是一篇給太空人(這裡就是指使用 Git 的程式設計師們)的指南,用來指導問題出現後的應對之法。 -> *飛行規則(Flight Rules)* 是記錄在手冊上的來之不易的一系列知識,記錄了某個事情發生的原因,以及怎樣一步一步的進行處理。本質上, 它們是特定場景的非常詳細的標準處理流程。 [...] +> 飛行規則(Flight Rules)是記錄在手冊上的來之不易的一系列知識,記錄了某個事情發生的原因,以及怎樣一步一步的進行處理。本質上,它們是特定場景的非常詳細的標準處理流程。[...] -> 自20世紀60年代初以來,NASA一直在捕捉(capturing)我們的失誤,災難和解決方案, 當時水星時代(Mercury-era)的地面小組首先開始將“經驗教訓”收集到一個綱要(compendium)中,該綱現在已經有上千個問題情景,從發動機故障到破損的艙口把手到計算機故障,以及它們對應的解決方案。 +> 自 20 世紀 60 年代初以來,NASA 一直在捕捉(capturing)失誤、災難和解決方案。當時水星時代(Mercury-era)的地面小組首先開始將「經驗教訓」收集到一個綱要(compendium)中,該綱現在已經有上千個問題情景,從發動機故障、到破損的艙口把手、再到計算機故障,以及它們對應的解決方案。 -— Chris Hadfield, *一個太空人的生活指南(An Astronaut's Guide to Life)*。 +——Chris Hadfield,《一個太空人的生活指南》(An Astronaut's Guide to Life) #### 這篇文章的約定 -為了清楚的表述,這篇文件裡的所有例子使用了自訂的bash 提示,以便指示當前分支和是否有暫存的變化(changes)。分支名用小括號括起來,分支名後面跟的`*`表示暫存的變化(changes)。 +為了清楚的表述,這篇文件裡的所有例子使用了自訂的 bash 提示,以便指示目前分支和是否有暫存的變化(changes)。分支名用小括號括起來,分支名後面跟的 `*` 表示暫存的變化(changes)。 [![Join the chat at https://gitter.im/k88hudson/git-flight-rules](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/k88hudson/git-flight-rules?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) **Table of Contents** *generated with [DocToc](https://github.com/thlorenz/doctoc)* - - [編輯提交(editting commits)](#%E7%BC%96%E8%BE%91%E6%8F%90%E4%BA%A4editting-commits) - - [我剛才提交了什麼?](#%E6%88%91%E5%88%9A%E6%89%8D%E6%8F%90%E4%BA%A4%E4%BA%86%E4%BB%80%E4%B9%88) - - [我的提交訊息(commit message)寫錯了](#%E6%88%91%E7%9A%84%E6%8F%90%E4%BA%A4%E4%BF%A1%E6%81%AFcommit-message%E5%86%99%E9%94%99%E4%BA%86) - - [我提交(commit)裡的使用者名稱和信箱不對](#%E6%88%91%E6%8F%90%E4%BA%A4commit%E9%87%8C%E7%9A%84%E7%94%A8%E6%88%B7%E5%90%8D%E5%92%8C%E9%82%AE%E7%AE%B1%E4%B8%8D%E5%AF%B9) - - [我想從一個提交(commit)裡移除一個文件](#%E6%88%91%E6%83%B3%E4%BB%8E%E4%B8%80%E4%B8%AA%E6%8F%90%E4%BA%A4commit%E9%87%8C%E7%A7%BB%E9%99%A4%E4%B8%80%E4%B8%AA%E6%96%87%E4%BB%B6) - - [我想刪除我的最後一次提交(commit)](#%E6%88%91%E6%83%B3%E5%88%A0%E9%99%A4%E6%88%91%E7%9A%84%E7%9A%84%E6%9C%80%E5%90%8E%E4%B8%80%E6%AC%A1%E6%8F%90%E4%BA%A4commit) - - [刪除任意提交(commit)](#%E5%88%A0%E9%99%A4%E4%BB%BB%E6%84%8F%E6%8F%90%E4%BA%A4commit) - - [我嘗試推一個修正後的提交(amended commit)到遠程,但是報錯:](#%E6%88%91%E5%B0%9D%E8%AF%95%E6%8E%A8%E4%B8%80%E4%B8%AA%E4%BF%AE%E6%AD%A3%E5%90%8E%E7%9A%84%E6%8F%90%E4%BA%A4amended-commit%E5%88%B0%E8%BF%9C%E7%A8%8B%E4%BD%86%E6%98%AF%E6%8A%A5%E9%94%99) - - [我意外的做了一次硬重設(hard reset),我想找回我的內容](#%E6%88%91%E6%84%8F%E5%A4%96%E7%9A%84%E5%81%9A%E4%BA%86%E4%B8%80%E6%AC%A1%E7%A1%AC%E9%87%8D%E7%BD%AEhard-reset%E6%88%91%E6%83%B3%E6%89%BE%E5%9B%9E%E6%88%91%E7%9A%84%E5%86%85%E5%AE%B9) - - [暫存(Staging)](#%E6%9A%82%E5%AD%98staging) - - [我需要把暫存的內容添加到上一次的提交(commit)](#%E6%88%91%E9%9C%80%E8%A6%81%E6%8A%8A%E6%9A%82%E5%AD%98%E7%9A%84%E5%86%85%E5%AE%B9%E6%B7%BB%E5%8A%A0%E5%88%B0%E4%B8%8A%E4%B8%80%E6%AC%A1%E7%9A%84%E6%8F%90%E4%BA%A4commit) - - [我想要暫存一個新文件的一部分,而不是這個文件的全部](#%E6%88%91%E6%83%B3%E8%A6%81%E6%9A%82%E5%AD%98%E4%B8%80%E4%B8%AA%E6%96%B0%E6%96%87%E4%BB%B6%E7%9A%84%E4%B8%80%E9%83%A8%E5%88%86%E8%80%8C%E4%B8%8D%E6%98%AF%E8%BF%99%E4%B8%AA%E6%96%87%E4%BB%B6%E7%9A%84%E5%85%A8%E9%83%A8) - - [我想把在一個文件裡的變化(changes)加到兩個提交(commit)裡](#%E6%88%91%E6%83%B3%E6%8A%8A%E5%9C%A8%E4%B8%80%E4%B8%AA%E6%96%87%E4%BB%B6%E9%87%8C%E7%9A%84%E5%8F%98%E5%8C%96changes%E5%8A%A0%E5%88%B0%E4%B8%A4%E4%B8%AA%E6%8F%90%E4%BA%A4commit%E9%87%8C) - - [我想把暫存的內容變成未暫存,把未暫存的內容暫存起來](#%E6%88%91%E6%83%B3%E6%8A%8A%E6%9A%82%E5%AD%98%E7%9A%84%E5%86%85%E5%AE%B9%E5%8F%98%E6%88%90%E6%9C%AA%E6%9A%82%E5%AD%98%E6%8A%8A%E6%9C%AA%E6%9A%82%E5%AD%98%E7%9A%84%E5%86%85%E5%AE%B9%E6%9A%82%E5%AD%98%E8%B5%B7%E6%9D%A5) - - [未暫存(Unstaged)的內容](#%E6%9C%AA%E6%9A%82%E5%AD%98unstaged%E7%9A%84%E5%86%85%E5%AE%B9) - - [我想把未暫存的內容移動到一個新分支](#%E6%88%91%E6%83%B3%E6%8A%8A%E6%9C%AA%E6%9A%82%E5%AD%98%E7%9A%84%E5%86%85%E5%AE%B9%E7%A7%BB%E5%8A%A8%E5%88%B0%E4%B8%80%E4%B8%AA%E6%96%B0%E5%88%86%E6%94%AF) - - [我想把未暫存的內容移動到另一個已存在的分支](#%E6%88%91%E6%83%B3%E6%8A%8A%E6%9C%AA%E6%9A%82%E5%AD%98%E7%9A%84%E5%86%85%E5%AE%B9%E7%A7%BB%E5%8A%A8%E5%88%B0%E5%8F%A6%E4%B8%80%E4%B8%AA%E5%B7%B2%E5%AD%98%E5%9C%A8%E7%9A%84%E5%88%86%E6%94%AF) - - [我想丟棄本地未提交的變化(uncommitted changes)](#%E6%88%91%E6%83%B3%E4%B8%A2%E5%BC%83%E6%9C%AC%E5%9C%B0%E6%9C%AA%E6%8F%90%E4%BA%A4%E7%9A%84%E5%8F%98%E5%8C%96uncommitted-changes) - - [我想丟棄某些未暫存的內容](#%E6%88%91%E6%83%B3%E4%B8%A2%E5%BC%83%E6%9F%90%E4%BA%9B%E6%9C%AA%E6%9A%82%E5%AD%98%E7%9A%84%E5%86%85%E5%AE%B9) - - [分支(Branches)](#%E5%88%86%E6%94%AFbranches) - - [我從錯誤的分支拉取了內容,或把內容拉取到了錯誤的分支](#%E6%88%91%E4%BB%8E%E9%94%99%E8%AF%AF%E7%9A%84%E5%88%86%E6%94%AF%E6%8B%89%E5%8F%96%E4%BA%86%E5%86%85%E5%AE%B9%E6%88%96%E6%8A%8A%E5%86%85%E5%AE%B9%E6%8B%89%E5%8F%96%E5%88%B0%E4%BA%86%E9%94%99%E8%AF%AF%E7%9A%84%E5%88%86%E6%94%AF) - - [我想扔掉本地的提交(commit),以便我的分支與遠程的保持一致](#%E6%88%91%E6%83%B3%E6%89%94%E6%8E%89%E6%9C%AC%E5%9C%B0%E7%9A%84%E6%8F%90%E4%BA%A4commit%E4%BB%A5%E4%BE%BF%E6%88%91%E7%9A%84%E5%88%86%E6%94%AF%E4%B8%8E%E8%BF%9C%E7%A8%8B%E7%9A%84%E4%BF%9D%E6%8C%81%E4%B8%80%E8%87%B4) - - [我需要提交到一個新分支,但錯誤的提交到了main](#%E6%88%91%E9%9C%80%E8%A6%81%E6%8F%90%E4%BA%A4%E5%88%B0%E4%B8%80%E4%B8%AA%E6%96%B0%E5%88%86%E6%94%AF%E4%BD%86%E9%94%99%E8%AF%AF%E7%9A%84%E6%8F%90%E4%BA%A4%E5%88%B0%E4%BA%86main) - - [我想保留來自另外一個ref-ish的整個文件](#%E6%88%91%E6%83%B3%E4%BF%9D%E7%95%99%E6%9D%A5%E8%87%AA%E5%8F%A6%E5%A4%96%E4%B8%80%E4%B8%AAref-ish%E7%9A%84%E6%95%B4%E4%B8%AA%E6%96%87%E4%BB%B6) - - [我把幾個提交(commit)提交到了同一個分支,而這些提交應該分布在不同的分支裡](#%E6%88%91%E6%8A%8A%E5%87%A0%E4%B8%AA%E6%8F%90%E4%BA%A4commit%E6%8F%90%E4%BA%A4%E5%88%B0%E4%BA%86%E5%90%8C%E4%B8%80%E4%B8%AA%E5%88%86%E6%94%AF%E8%80%8C%E8%BF%99%E4%BA%9B%E6%8F%90%E4%BA%A4%E5%BA%94%E8%AF%A5%E5%88%86%E5%B8%83%E5%9C%A8%E4%B8%8D%E5%90%8C%E7%9A%84%E5%88%86%E6%94%AF%E9%87%8C) - - [我想刪除上遊(upstream)分支被刪除了的本地分支](#%E6%88%91%E6%83%B3%E5%88%A0%E9%99%A4%E4%B8%8A%E6%B8%B8upstream%E5%88%86%E6%94%AF%E8%A2%AB%E5%88%A0%E9%99%A4%E4%BA%86%E7%9A%84%E6%9C%AC%E5%9C%B0%E5%88%86%E6%94%AF) - - [我不小心刪除了我的分支](#%E6%88%91%E4%B8%8D%E5%B0%8F%E5%BF%83%E5%88%A0%E9%99%A4%E4%BA%86%E6%88%91%E7%9A%84%E5%88%86%E6%94%AF) - - [我想刪除一個分支](#%E6%88%91%E6%83%B3%E5%88%A0%E9%99%A4%E4%B8%80%E4%B8%AA%E5%88%86%E6%94%AF) - - [我想從別人正在工作的遠程分枝籤出(checkout)一個分支](#%E6%88%91%E6%83%B3%E4%BB%8E%E5%88%AB%E4%BA%BA%E6%AD%A3%E5%9C%A8%E5%B7%A5%E4%BD%9C%E7%9A%84%E8%BF%9C%E7%A8%8B%E5%88%86%E6%94%AF%E7%AD%BE%E5%87%BAcheckout%E4%B8%80%E4%B8%AA%E5%88%86%E6%94%AF) - - [Rebasing 和合併(Merging)](#rebasing-%E5%92%8C%E5%90%88%E5%B9%B6merging) - - [我想撤銷rebase/merge](#%E6%88%91%E6%83%B3%E6%92%A4%E9%94%80rebasemerge) - - [我已經rebase過, 但是我不想強推(force push)](#%E6%88%91%E5%B7%B2%E7%BB%8Frebase%E8%BF%87-%E4%BD%86%E6%98%AF%E6%88%91%E4%B8%8D%E6%83%B3%E5%BC%BA%E6%8E%A8force-push) - - [我需要組合(combine)幾個提交(commit)](#%E6%88%91%E9%9C%80%E8%A6%81%E7%BB%84%E5%90%88combine%E5%87%A0%E4%B8%AA%E6%8F%90%E4%BA%A4commit) - - [安全合併(merging)策略](#%E5%AE%89%E5%85%A8%E5%90%88%E5%B9%B6merging%E7%AD%96%E7%95%A5) - - [我需要將一個分支合併成一個提交(commit)](#%E6%88%91%E9%9C%80%E8%A6%81%E5%B0%86%E4%B8%80%E4%B8%AA%E5%88%86%E6%94%AF%E5%90%88%E5%B9%B6%E6%88%90%E4%B8%80%E4%B8%AA%E6%8F%90%E4%BA%A4commit) - - [我只想組合(combine)未推的提交(unpushed commit)](#%E6%88%91%E5%8F%AA%E6%83%B3%E7%BB%84%E5%90%88combine%E6%9C%AA%E6%8E%A8%E7%9A%84%E6%8F%90%E4%BA%A4unpushed-commit) - - [檢查是否分支上的所有提交(commit)都合併(merge)過了](#%E6%A3%80%E6%9F%A5%E6%98%AF%E5%90%A6%E5%88%86%E6%94%AF%E4%B8%8A%E7%9A%84%E6%89%80%E6%9C%89%E6%8F%90%E4%BA%A4commit%E9%83%BD%E5%90%88%E5%B9%B6merge%E8%BF%87%E4%BA%86) - - [互動式rebase(interactive rebase)可能出現的問題](#%E4%BA%A4%E4%BA%92%E5%BC%8Frebaseinteractive-rebase%E5%8F%AF%E8%83%BD%E5%87%BA%E7%8E%B0%E7%9A%84%E9%97%AE%E9%A2%98) - - [這個rebase 編輯螢幕出現'noop'](#%E8%BF%99%E4%B8%AArebase-%E7%BC%96%E8%BE%91%E5%B1%8F%E5%B9%95%E5%87%BA%E7%8E%B0noop) - - [有衝突的情況](#%E6%9C%89%E5%86%B2%E7%AA%81%E7%9A%84%E6%83%85%E5%86%B5) - - [Stash](#stash) - - [暫存所有改動](#%E6%9A%82%E5%AD%98%E6%89%80%E6%9C%89%E6%94%B9%E5%8A%A8) - - [暫存指定文件](#%E6%9A%82%E5%AD%98%E6%8C%87%E5%AE%9A%E6%96%87%E4%BB%B6) - - [暫存時記錄消息](#%E6%9A%82%E5%AD%98%E6%97%B6%E8%AE%B0%E5%BD%95%E6%B6%88%E6%81%AF) - - [使用某個指定暫存](#%E4%BD%BF%E7%94%A8%E6%9F%90%E4%B8%AA%E6%8C%87%E5%AE%9A%E6%9A%82%E5%AD%98) - - [暫存時保留未暫存的內容](#%E6%9A%82%E5%AD%98%E6%97%B6%E4%BF%9D%E7%95%99%E6%9C%AA%E6%9A%82%E5%AD%98%E7%9A%84%E5%86%85%E5%AE%B9) - - [雜項(Miscellaneous Objects)](#%E6%9D%82%E9%A1%B9miscellaneous-objects) - - [複製所有子模組](#%E5%85%8B%E9%9A%86%E6%89%80%E6%9C%89%E5%AD%90%E6%A8%A1%E5%9D%97) - - [刪除標籤(tag)](#%E5%88%A0%E9%99%A4%E6%A0%87%E7%AD%BEtag) - - [恢覆已刪除標籤(tag)](#%E6%81%A2%E5%A4%8D%E5%B7%B2%E5%88%A0%E9%99%A4%E6%A0%87%E7%AD%BEtag) - - [已刪除補丁(patch)](#%E5%B7%B2%E5%88%A0%E9%99%A4%E8%A1%A5%E4%B8%81patch) - - [跟蹤文件(Tracking Files)](#%E8%B7%9F%E8%B8%AA%E6%96%87%E4%BB%B6tracking-files) - - [我只想改變一個檔案名字的大小寫,而不修改內容](#%E6%88%91%E5%8F%AA%E6%83%B3%E6%94%B9%E5%8F%98%E4%B8%80%E4%B8%AA%E6%96%87%E4%BB%B6%E5%90%8D%E5%AD%97%E7%9A%84%E5%A4%A7%E5%B0%8F%E5%86%99%E8%80%8C%E4%B8%8D%E4%BF%AE%E6%94%B9%E5%86%85%E5%AE%B9) - - [我想從Git刪除一個文件,但保留該文件](#%E6%88%91%E6%83%B3%E4%BB%8Egit%E5%88%A0%E9%99%A4%E4%B8%80%E4%B8%AA%E6%96%87%E4%BB%B6%E4%BD%86%E4%BF%9D%E7%95%99%E8%AF%A5%E6%96%87%E4%BB%B6) - - [配置(Configuration)](#%E9%85%8D%E7%BD%AEconfiguration) - - [我想給一些Git命令添加別名(alias)](#%E6%88%91%E6%83%B3%E7%BB%99%E4%B8%80%E4%BA%9Bgit%E5%91%BD%E4%BB%A4%E6%B7%BB%E5%8A%A0%E5%88%AB%E5%90%8Dalias) - - [我想快取一個倉庫(repository)的使用者名稱和密碼](#%E6%88%91%E6%83%B3%E7%BC%93%E5%AD%98%E4%B8%80%E4%B8%AA%E4%BB%93%E5%BA%93repository%E7%9A%84%E7%94%A8%E6%88%B7%E5%90%8D%E5%92%8C%E5%AF%86%E7%A0%81) - - [我不知道我做錯了些什麼](#%E6%88%91%E4%B8%8D%E7%9F%A5%E9%81%93%E6%88%91%E5%81%9A%E9%94%99%E4%BA%86%E4%BA%9B%E4%BB%80%E4%B9%88) -- [其它資源(Other Resources)](#%E5%85%B6%E5%AE%83%E8%B5%84%E6%BA%90other-resources) - - [書(Books)](#%E4%B9%A6books) - - [教學(Tutorials)](#%E6%95%99%E7%A8%8Btutorials) - - [腳本和工具(Scripts and Tools)](#%E8%84%9A%E6%9C%AC%E5%92%8C%E5%B7%A5%E5%85%B7scripts-and-tools) - - [GUI用戶端(GUI Clients)](#gui%E5%AE%A2%E6%88%B7%E7%AB%AFgui-clients) + - [編輯提交(editting commits)](#%E7%B7%A8%E8%BC%AF%E6%8F%90%E4%BA%A4editting-commits) + - [我剛才提交了什麼?](#%E6%88%91%E5%89%9B%E6%89%8D%E6%8F%90%E4%BA%A4%E4%BA%86%E4%BB%80%E9%BA%BC) + - [我的提交訊息(commit message)寫錯了](#%E6%88%91%E7%9A%84%E6%8F%90%E4%BA%A4%E8%A8%8A%E6%81%AFcommit-message%E5%AF%AB%E9%8C%AF%E4%BA%86) + - [我提交(commit)裡的使用者名稱和信箱不對](#%E6%88%91%E6%8F%90%E4%BA%A4commit%E8%A3%A1%E7%9A%84%E4%BD%BF%E7%94%A8%E8%80%85%E5%90%8D%E7%A8%B1%E5%92%8C%E4%BF%A1%E7%AE%B1%E4%B8%8D%E5%B0%8D) + - [我想從一個提交(commit)裡移除一個文件](#%E6%88%91%E6%83%B3%E5%BE%9E%E4%B8%80%E5%80%8B%E6%8F%90%E4%BA%A4commit%E8%A3%A1%E7%A7%BB%E9%99%A4%E4%B8%80%E5%80%8B%E6%96%87%E4%BB%B6) + - [我想刪除我最後一次提交(commit)](#%E6%88%91%E6%83%B3%E5%88%AA%E9%99%A4%E6%88%91%E6%9C%80%E5%BE%8C%E4%B8%80%E6%AC%A1%E6%8F%90%E4%BA%A4commit) + - [刪除任意提交(commit)](#%E5%88%AA%E9%99%A4%E4%BB%BB%E6%84%8F%E6%8F%90%E4%BA%A4commit) + - [我嘗試推送一個修正後的提交(amended commit)到遠端,但是報錯](#%E6%88%91%E5%98%97%E8%A9%A6%E6%8E%A8%E9%80%81%E4%B8%80%E5%80%8B%E4%BF%AE%E6%AD%A3%E5%BE%8C%E7%9A%84%E6%8F%90%E4%BA%A4amended-commit%E5%88%B0%E9%81%A0%E7%AB%AF%E4%BD%86%E6%98%AF%E5%A0%B1%E9%8C%AF) + - [我意外地硬重設(hard reset)了,我想找回我的內容](#%E6%88%91%E6%84%8F%E5%A4%96%E5%9C%B0%E7%A1%AC%E9%87%8D%E8%A8%ADhard-reset%E4%BA%86%E6%88%91%E6%83%B3%E6%89%BE%E5%9B%9E%E6%88%91%E7%9A%84%E5%85%A7%E5%AE%B9) + - [暫存(staging)](#%E6%9A%AB%E5%AD%98staging) + - [我需要把暫存的內容添加到上一次的提交(commit)](#%E6%88%91%E9%9C%80%E8%A6%81%E6%8A%8A%E6%9A%AB%E5%AD%98%E7%9A%84%E5%85%A7%E5%AE%B9%E6%B7%BB%E5%8A%A0%E5%88%B0%E4%B8%8A%E4%B8%80%E6%AC%A1%E7%9A%84%E6%8F%90%E4%BA%A4commit) + - [我想要暫存一個新文件的一部分,而不是這個文件的全部](#%E6%88%91%E6%83%B3%E8%A6%81%E6%9A%AB%E5%AD%98%E4%B8%80%E5%80%8B%E6%96%B0%E6%96%87%E4%BB%B6%E7%9A%84%E4%B8%80%E9%83%A8%E5%88%86%E8%80%8C%E4%B8%8D%E6%98%AF%E9%80%99%E5%80%8B%E6%96%87%E4%BB%B6%E7%9A%84%E5%85%A8%E9%83%A8) + - [我想把在一個文件裡的變化(changes)加到兩個提交(commit)裡](#%E6%88%91%E6%83%B3%E6%8A%8A%E5%9C%A8%E4%B8%80%E5%80%8B%E6%96%87%E4%BB%B6%E8%A3%A1%E7%9A%84%E8%AE%8A%E5%8C%96changes%E5%8A%A0%E5%88%B0%E5%85%A9%E5%80%8B%E6%8F%90%E4%BA%A4commit%E8%A3%A1) + - [我想把暫存的內容變成未暫存,把未暫存的內容暫存起來](#%E6%88%91%E6%83%B3%E6%8A%8A%E6%9A%AB%E5%AD%98%E7%9A%84%E5%85%A7%E5%AE%B9%E8%AE%8A%E6%88%90%E6%9C%AA%E6%9A%AB%E5%AD%98%E6%8A%8A%E6%9C%AA%E6%9A%AB%E5%AD%98%E7%9A%84%E5%85%A7%E5%AE%B9%E6%9A%AB%E5%AD%98%E8%B5%B7%E4%BE%86) + - [未暫存(unstaged)的變化](#%E6%9C%AA%E6%9A%AB%E5%AD%98unstaged%E7%9A%84%E8%AE%8A%E5%8C%96) + - [我想把未暫存的變化移動到新分支](#%E6%88%91%E6%83%B3%E6%8A%8A%E6%9C%AA%E6%9A%AB%E5%AD%98%E7%9A%84%E8%AE%8A%E5%8C%96%E7%A7%BB%E5%8B%95%E5%88%B0%E6%96%B0%E5%88%86%E6%94%AF) + - [我想把未暫存的變化移動到另一個已存在的分支](#%E6%88%91%E6%83%B3%E6%8A%8A%E6%9C%AA%E6%9A%AB%E5%AD%98%E7%9A%84%E8%AE%8A%E5%8C%96%E7%A7%BB%E5%8B%95%E5%88%B0%E5%8F%A6%E4%B8%80%E5%80%8B%E5%B7%B2%E5%AD%98%E5%9C%A8%E7%9A%84%E5%88%86%E6%94%AF) + - [我想丟棄本地未提交的變化(uncommitted changes)](#%E6%88%91%E6%83%B3%E4%B8%9F%E6%A3%84%E6%9C%AC%E5%9C%B0%E6%9C%AA%E6%8F%90%E4%BA%A4%E7%9A%84%E8%AE%8A%E5%8C%96uncommitted-changes) + - [我想丟棄某些未暫存的變化](#%E6%88%91%E6%83%B3%E4%B8%9F%E6%A3%84%E6%9F%90%E4%BA%9B%E6%9C%AA%E6%9A%AB%E5%AD%98%E7%9A%84%E8%AE%8A%E5%8C%96) + - [分支(branches)](#%E5%88%86%E6%94%AFbranches) + - [我從錯誤的分支拉取了內容,或把內容拉取到了錯誤的分支](#%E6%88%91%E5%BE%9E%E9%8C%AF%E8%AA%A4%E7%9A%84%E5%88%86%E6%94%AF%E6%8B%89%E5%8F%96%E4%BA%86%E5%85%A7%E5%AE%B9%E6%88%96%E6%8A%8A%E5%85%A7%E5%AE%B9%E6%8B%89%E5%8F%96%E5%88%B0%E4%BA%86%E9%8C%AF%E8%AA%A4%E7%9A%84%E5%88%86%E6%94%AF) + - [我想丟棄本地的提交(commit),以讓分支與遠端保持一致](#%E6%88%91%E6%83%B3%E4%B8%9F%E6%A3%84%E6%9C%AC%E5%9C%B0%E7%9A%84%E6%8F%90%E4%BA%A4commit%E4%BB%A5%E8%AE%93%E5%88%86%E6%94%AF%E8%88%87%E9%81%A0%E7%AB%AF%E4%BF%9D%E6%8C%81%E4%B8%80%E8%87%B4) + - [我需要提交到一個新分支,但錯誤的提交到了 `main`](#%E6%88%91%E9%9C%80%E8%A6%81%E6%8F%90%E4%BA%A4%E5%88%B0%E4%B8%80%E5%80%8B%E6%96%B0%E5%88%86%E6%94%AF%E4%BD%86%E9%8C%AF%E8%AA%A4%E7%9A%84%E6%8F%90%E4%BA%A4%E5%88%B0%E4%BA%86-main) + - [我想保留來自另外一個 ref-ish 的整個文件](#%E6%88%91%E6%83%B3%E4%BF%9D%E7%95%99%E4%BE%86%E8%87%AA%E5%8F%A6%E5%A4%96%E4%B8%80%E5%80%8B-ref-ish-%E7%9A%84%E6%95%B4%E5%80%8B%E6%96%87%E4%BB%B6) + - [我把幾個提交(commit)提交到了同一個分支,而這些提交應該在不同的分支上](#%E6%88%91%E6%8A%8A%E5%B9%BE%E5%80%8B%E6%8F%90%E4%BA%A4commit%E6%8F%90%E4%BA%A4%E5%88%B0%E4%BA%86%E5%90%8C%E4%B8%80%E5%80%8B%E5%88%86%E6%94%AF%E8%80%8C%E9%80%99%E4%BA%9B%E6%8F%90%E4%BA%A4%E6%87%89%E8%A9%B2%E5%9C%A8%E4%B8%8D%E5%90%8C%E7%9A%84%E5%88%86%E6%94%AF%E4%B8%8A) + - [我想刪除上遊(upstream)刪除了的本地分支](#%E6%88%91%E6%83%B3%E5%88%AA%E9%99%A4%E4%B8%8A%E9%81%8Aupstream%E5%88%AA%E9%99%A4%E4%BA%86%E7%9A%84%E6%9C%AC%E5%9C%B0%E5%88%86%E6%94%AF) + - [我不小心刪除了分支](#%E6%88%91%E4%B8%8D%E5%B0%8F%E5%BF%83%E5%88%AA%E9%99%A4%E4%BA%86%E5%88%86%E6%94%AF) + - [我想刪除一個分支](#%E6%88%91%E6%83%B3%E5%88%AA%E9%99%A4%E4%B8%80%E5%80%8B%E5%88%86%E6%94%AF) + - [我想從別人正在工作的遠端分支簽出(checkout)一個分支](#%E6%88%91%E6%83%B3%E5%BE%9E%E5%88%A5%E4%BA%BA%E6%AD%A3%E5%9C%A8%E5%B7%A5%E4%BD%9C%E7%9A%84%E9%81%A0%E7%AB%AF%E5%88%86%E6%94%AF%E7%B0%BD%E5%87%BAcheckout%E4%B8%80%E5%80%8B%E5%88%86%E6%94%AF) + - [變基(rebase)與合併(merge)](#%E8%AE%8A%E5%9F%BArebase%E8%88%87%E5%90%88%E4%BD%B5merge) + - [撤銷變基或合併](#%E6%92%A4%E9%8A%B7%E8%AE%8A%E5%9F%BA%E6%88%96%E5%90%88%E4%BD%B5) + - [我做了變基,但是我不想強制推送(force push)](#%E6%88%91%E5%81%9A%E4%BA%86%E8%AE%8A%E5%9F%BA%E4%BD%86%E6%98%AF%E6%88%91%E4%B8%8D%E6%83%B3%E5%BC%B7%E5%88%B6%E6%8E%A8%E9%80%81force-push) + - [我需要組合(combine)幾個提交(commit)](#%E6%88%91%E9%9C%80%E8%A6%81%E7%B5%84%E5%90%88combine%E5%B9%BE%E5%80%8B%E6%8F%90%E4%BA%A4commit) + - [安全合併的策略](#%E5%AE%89%E5%85%A8%E5%90%88%E4%BD%B5%E7%9A%84%E7%AD%96%E7%95%A5) + - [我需要將一個分支合併成一個提交](#%E6%88%91%E9%9C%80%E8%A6%81%E5%B0%87%E4%B8%80%E5%80%8B%E5%88%86%E6%94%AF%E5%90%88%E4%BD%B5%E6%88%90%E4%B8%80%E5%80%8B%E6%8F%90%E4%BA%A4) + - [我只想組合(combine)未推送的提交](#%E6%88%91%E5%8F%AA%E6%83%B3%E7%B5%84%E5%90%88combine%E6%9C%AA%E6%8E%A8%E9%80%81%E7%9A%84%E6%8F%90%E4%BA%A4) + - [檢查分支上的所有提交是否都合併了](#%E6%AA%A2%E6%9F%A5%E5%88%86%E6%94%AF%E4%B8%8A%E7%9A%84%E6%89%80%E6%9C%89%E6%8F%90%E4%BA%A4%E6%98%AF%E5%90%A6%E9%83%BD%E5%90%88%E4%BD%B5%E4%BA%86) + - [互動式變基(interactive rebase)可能出現的問題](#%E4%BA%92%E5%8B%95%E5%BC%8F%E8%AE%8A%E5%9F%BAinteractive-rebase%E5%8F%AF%E8%83%BD%E5%87%BA%E7%8F%BE%E7%9A%84%E5%95%8F%E9%A1%8C) + - [編輯介面出現「noop」](#%E7%B7%A8%E8%BC%AF%E4%BB%8B%E9%9D%A2%E5%87%BA%E7%8F%BEnoop) + - [有衝突的情況](#%E6%9C%89%E8%A1%9D%E7%AA%81%E7%9A%84%E6%83%85%E6%B3%81) + - [儲藏(stash)](#%E5%84%B2%E8%97%8Fstash) + - [儲藏所有變化](#%E5%84%B2%E8%97%8F%E6%89%80%E6%9C%89%E8%AE%8A%E5%8C%96) + - [儲藏指定檔案](#%E5%84%B2%E8%97%8F%E6%8C%87%E5%AE%9A%E6%AA%94%E6%A1%88) + - [儲藏時附加訊息](#%E5%84%B2%E8%97%8F%E6%99%82%E9%99%84%E5%8A%A0%E8%A8%8A%E6%81%AF) + - [應用(apply)指定儲藏](#%E6%87%89%E7%94%A8apply%E6%8C%87%E5%AE%9A%E5%84%B2%E8%97%8F) + - [儲藏時保留未暫存的內容](#%E5%84%B2%E8%97%8F%E6%99%82%E4%BF%9D%E7%95%99%E6%9C%AA%E6%9A%AB%E5%AD%98%E7%9A%84%E5%85%A7%E5%AE%B9) + - [雜項](#%E9%9B%9C%E9%A0%85) + - [複製所有子模組](#%E8%A4%87%E8%A3%BD%E6%89%80%E6%9C%89%E5%AD%90%E6%A8%A1%E7%B5%84) + - [刪除標籤(tag)](#%E5%88%AA%E9%99%A4%E6%A8%99%E7%B1%A4tag) + - [恢復已刪除標籤(tag)](#%E6%81%A2%E5%BE%A9%E5%B7%B2%E5%88%AA%E9%99%A4%E6%A8%99%E7%B1%A4tag) + - [已刪除補丁(patch)](#%E5%B7%B2%E5%88%AA%E9%99%A4%E8%A3%9C%E4%B8%81patch) + - [追蹤檔案(tracking files)](#%E8%BF%BD%E8%B9%A4%E6%AA%94%E6%A1%88tracking-files) + - [我只想改變一個檔案名字的大小寫,而不修改內容](#%E6%88%91%E5%8F%AA%E6%83%B3%E6%94%B9%E8%AE%8A%E4%B8%80%E5%80%8B%E6%AA%94%E6%A1%88%E5%90%8D%E5%AD%97%E7%9A%84%E5%A4%A7%E5%B0%8F%E5%AF%AB%E8%80%8C%E4%B8%8D%E4%BF%AE%E6%94%B9%E5%85%A7%E5%AE%B9) + - [我想從 Git 刪除一個檔案,但保留該檔案](#%E6%88%91%E6%83%B3%E5%BE%9E-git-%E5%88%AA%E9%99%A4%E4%B8%80%E5%80%8B%E6%AA%94%E6%A1%88%E4%BD%86%E4%BF%9D%E7%95%99%E8%A9%B2%E6%AA%94%E6%A1%88) + - [組態(configuration)](#%E7%B5%84%E6%85%8Bconfiguration) + - [我想為 Git 命令設定別名(alias)](#%E6%88%91%E6%83%B3%E7%82%BA-git-%E5%91%BD%E4%BB%A4%E8%A8%AD%E5%AE%9A%E5%88%A5%E5%90%8Dalias) + - [我想快取一個倉庫(repository)的使用者名稱和密碼](#%E6%88%91%E6%83%B3%E5%BF%AB%E5%8F%96%E4%B8%80%E5%80%8B%E5%80%89%E5%BA%ABrepository%E7%9A%84%E4%BD%BF%E7%94%A8%E8%80%85%E5%90%8D%E7%A8%B1%E5%92%8C%E5%AF%86%E7%A2%BC) + - [我不知道我做錯了什麼](#%E6%88%91%E4%B8%8D%E7%9F%A5%E9%81%93%E6%88%91%E5%81%9A%E9%8C%AF%E4%BA%86%E4%BB%80%E9%BA%BC) +- [其他資源](#%E5%85%B6%E4%BB%96%E8%B3%87%E6%BA%90) + - [書籍](#%E6%9B%B8%E7%B1%8D) + - [教學](#%E6%95%99%E5%AD%B8) + - [腳本和工具](#%E8%85%B3%E6%9C%AC%E5%92%8C%E5%B7%A5%E5%85%B7) + - [GUI 客戶端](#gui-%E5%AE%A2%E6%88%B6%E7%AB%AF) -## 編輯提交(editting commits) +## 編輯提交(editting commits) -### 我剛才提交了什麼? +### 我剛才提交了什麼? -如果你用 `git commit -a` 提交了一次變化(changes),而你又不確定到底這次提交了哪些內容。 你就可以用下面的命令顯示當前`HEAD`上的最近一次的提交(commit): +如果你用 `git commit -a` 提交了一次變化(changes),而你又不確定到底這次提交了哪些內容,你可以用以下命令顯示目前 `HEAD` 上的最近一次的提交(commit): ```sh (main)$ git show @@ -111,36 +111,36 @@ $ git log -n1 -p ``` -### 我的提交訊息(commit message)寫錯了 +### 我的提交訊息(commit message)寫錯了 -如果你的提交訊息(commit message)寫錯了且這次提交(commit)還沒有推(push), 你可以透過下面的方法來修改提交訊息(commit message): +如果你的提交訊息(commit message)寫錯了,且這次提交(commit)還沒有推送(push),你可以透過下面的方法來修改提交訊息(commit message): ```sh $ git commit --amend --only ``` -這會打開你的默認編輯器, 在這裡你可以編輯訊息. 另一方面, 你也可以用一條命令一次完成: +這會使用你的預設編輯器來完成。你也可以只使用一個命令: ```sh $ git commit --amend --only -m 'xxxxxxx' ``` -如果你已經推(push)了這次提交(commit), 你可以修改這次提交(commit)然後強推(force push), 但是不推薦這麼做。 +如果你已經推送(push)了這次提交(commit),你可以修改這次提交(commit)然後強制推送(force push),但是不推薦這麼做。 -### 我提交(commit)裡的使用者名稱和信箱不對 +### 我提交(commit)裡的使用者名稱和信箱不對 -如果這只是單個提交(commit),修改它: +如果這只是單個提交(commit),修改它: ```sh $ git commit --amend --author "New Authorname " ``` -如果你需要修改所有歷史, 參考 'git filter-branch'的指南頁. +如果你需要修改所有歷史,參考 `git filter-branch` 的手冊。 -### 我想從一個提交(commit)裡移除一個文件 +### 我想從一個提交(commit)裡移除一個文件 -通過下面的方法,從一個提交(commit)裡移除一個文件: +通過下面的方法,從一個提交(commit)裡移除一個文件: ```sh $ git checkout HEAD^ myfile @@ -148,41 +148,41 @@ $ git add -A $ git commit --amend ``` -這將非常有用,當你有一個開放的補丁(open patch),你往上面提交了一個不必要的文件,你需要強推(force push)去更新這個遠程補丁。 +這非常有用,當你有一個開放的補丁(open patch),你往上面提交了一個不必要的文件,你需要強制推送(force push)去更新這個遠程補丁。 -### 我想刪除我的的最後一次提交(commit) +### 我想刪除我最後一次提交(commit) -如果你需要刪除推了的提交(pushed commits),你可以使用下面的方法。可是,這會不可逆的改變你的歷史,也會搞亂那些已經從該倉庫拉取(pulled)了的人的歷史。簡而言之,如果你不是很確定,千萬不要這麼做。 +如果你需要刪除推送了的提交(pushed commits),你可以使用以下方法。但是,這將不可逆的改變你的歷史,也會搞亂那些已經從該倉庫拉取(pulled)了的人的歷史。簡而言之,如果你不是很確定,千萬不要這麼做。 ```sh $ git reset HEAD^ --hard $ git push -f [remote] [branch] ``` -如果你還沒有推到遠程, 把Git重設(reset)到你最後一次提交前的狀態就可以了(同時保存暫存的變化): +如果你還沒有推送到遠端,重設(reset)到你最後一次提交前的狀態就可以了(同時保存暫存的變化): ``` (my-branch*)$ git reset --soft HEAD@{1} ``` -這只能在沒有推送之前有用. 如果你已經推了, 唯一安全能做的是 `git revert SHAofBadCommit`, 那會創建一個新的提交(commit)用於撤消前一個提交的所有變化(changes); 或者, 如果你推的這個分支是rebase-safe的 (例如: 其它開發者不會從這個分支拉), 只需要使用 `git push -f`; 更多, 請參考 [the above section](#deleteremove-last-pushed-commit)。 +這只能在推送之前使用。如果你已經推送了,唯一安全的做法是 `git revert SHAofBadCommit`,那會創建一個新的提交(commit)來撤消前一個提交的所有變化(changes);或者,如果這個分支是 rebase-safe 的(例如:其他開發者不會從這個分支拉取),只需要使用 `git push -f`;參見[上一節](#deleteremove-last-pushed-commit)。 -### 刪除任意提交(commit) +### 刪除任意提交(commit) -同樣的警告:不到萬不得已的時候不要這麼做. +同樣,除非必須,否則不要這麼做。 ```sh $ git rebase --onto SHA1_OF_BAD_COMMIT^ SHA1_OF_BAD_COMMIT $ git push -f [remote] [branch] ``` -或者做一個 [互動式rebase](#interactive-rebase) 刪除那些你想要刪除的提交(commit)裡所對應的行。 +或者使用[互動式變基(interactive rebase)](#interactive-rebase) 刪除那些你想要刪除的提交(commit)所對應的行。 -### 我嘗試推一個修正後的提交(amended commit)到遠程,但是報錯: +### 我嘗試推送一個修正後的提交(amended commit)到遠端,但是報錯 ```sh To https://github.com/yourusername/repo.git @@ -194,91 +194,88 @@ hint: 'git pull ...') before pushing again. hint: See the 'Note about fast-forwards' in 'git push --help' for details. ``` -注意, rebasing(見下面)和修正(amending)會用一個**新的提交(commit)代替舊的**, 所以如果之前你已經往遠程倉庫上推過一次修正前的提交(commit),那你現在就必須強推(force push) (`-f`)。 注意 – *總是* 確保你指明一個分支! +注意,變基(rebasing)和修正(amending)會用一個新的提交(commit)取代舊的,所以如果舊的提交已經推送到遠端上了,那你必須強制推送(force push)。注意:總是確保你指明一個分支! ```sh (my-branch)$ git push origin mybranch -f ``` -一般來說, **要避免強推**. 最好是創建和推(push)一個新的提交(commit),而不是強推一個修正後的提交。後者會使那些與該分支或該分支的子分支工作的開發者,在源歷史中產生衝突。 +一般來說,要避免強制推送。最好是創建和推送一個新的提交(commit),而不是強推一個修正後的提交。後者會使在該分支或該分支的子分支上工作的開發者,在源歷史中產生衝突。 -### 我意外的做了一次硬重設(hard reset),我想找回我的內容 +### 我意外地硬重設(hard reset)了,我想找回我的內容 -如果你意外的做了 `git reset --hard`, 你通常能找回你的提交(commit), 因為Git對每件事都會有日誌,且都會保存幾天。 +如果你意外地做了 `git reset --hard`,你通常能找回你的提交(commit),因為 Git 對每件事都會有日誌,且都會保存幾天。 ```sh (main)$ git reflog ``` -你將會看到一個你過去提交(commit)的列表, 和一個重設的提交。 選擇你想要回到的提交(commit)的SHA,再重設一次: +你將會看到一個你過去提交(commit)的列表,和一個重設的提交。選擇你想要回到的提交(commit)的 SHA,再重設一次: ```sh (main)$ git reset --hard SHA1234 ``` -這樣就完成了。 - -## 暫存(Staging) +## 暫存(staging) -### 我需要把暫存的內容添加到上一次的提交(commit) +### 我需要把暫存的內容添加到上一次的提交(commit) ```sh (my-branch*)$ git commit --amend - ``` ### 我想要暫存一個新文件的一部分,而不是這個文件的全部 -一般來說, 如果你想暫存一個文件的一部分, 你可這樣做: +一般來說,如果你想暫存一個文件的一部分,你可以使用以下命令來開啟互動式介面,並使用 `s` 選項來選擇想要的行。 ```sh -$ git add --patch filename.x +$ git add --patch filename.x # 或 `-p`。 ``` -`-p` 簡寫。這會打開交互模式, 你將能夠用 `s` 選項來分隔提交(commit); 然而, 如果這個文件是新的, 會沒有這個選擇, 添加一個新文件時, 這樣做: +然而,當這個檔案是新的,則需改用以下命令: ```sh $ git add -N filename.x ``` -然後, 你需要用 `e` 選項來手動選擇需要添加的行,執行 `git diff --cached` 將會顯示哪些行暫存了哪些行只是保存在本地了。 +然後,你需要用 `e` 選項來選擇需要添加的行,執行 `git diff --cached` 將會顯示哪些行暫存了、哪些行只是保存在本地了。 -### 我想把在一個文件裡的變化(changes)加到兩個提交(commit)裡 +### 我想把在一個文件裡的變化(changes)加到兩個提交(commit)裡 -`git add` 會把整個文件加入到一個提交. `git add -p` 允許互動式的選擇你想要提交的部分. +`git add` 會把整個文件加入到一個提交。`git add -p` 則允許你互動式地選擇想要提交的部分。 ### 我想把暫存的內容變成未暫存,把未暫存的內容暫存起來 -多數情況下,你應該將所有的內容變為未暫存,然後再選擇你想要的內容進行commit。 -但假定你就是想要這麼做,這裡你可以創建一個臨時的commit來保存你已暫存的內容,然後暫存你的未暫存的內容並進行stash。然後reset最後一個commit將原本暫存的內容變為未暫存,最後stash pop回來。 +多數情況下,你應該將所有的內容變為未暫存,然後再加入(add)你想要的內容提交(commit)。 +但如果你就是想這麼做,你可以創建一個臨時的提交來儲存你已暫存的內容,然後加入未暫存的內容並儲藏(stash)。最後,重設(reset)最後一個提交將原本暫存的內容變為未暫存,最後彈出儲藏(pop stash)。 ```sh -$ git commit -m "WIP" -$ git add . -$ git stash -$ git reset HEAD^ -$ git stash pop --index 0 +$ git commit -m "WIP" # 將之前已暫存的內容提交。 +$ git add . # 加入未暫存的內容。 +$ git stash # 儲藏剛剛加入的內容。 +$ git reset HEAD^ # 重設到父提交。 +$ git stash pop --index 0 # 彈出儲藏。 ``` -注意1: 這裡使用`pop`僅僅是因為想盡可能保持冪等。 -注意2: 假如你不加上`--index`你會把暫存的文件標記為為儲存.這個[連結](https://stackoverflow.com/questions/31595873/git-stash-with-staged-files-does-stash-convert-staged-files-to-unstaged?answertab=active#tab-top) 解釋得比較清楚。(不過是英文的,其大意是說,這是一個較為底層的問題,stash時會做2個commit,其中一個會記錄index狀態,staged的文件等東西,另一個紀錄worktree和其他的一些東西,如果你不在apply時加index,git會把兩個一起銷毀,所以staged裡就空了)。 +註一:這裡使用 `pop` 僅僅是因為想盡可能保持冪等。 +註二:假如不加上 `--index`,會把暫存的文件標記為未暫存。[這裡](https://stackoverflow.com/questions/31595873/git-stash-with-staged-files-does-stash-convert-staged-files-to-unstaged?answertab=active#tab-top)解釋得比較清楚。(其大意是說,這是一個較為底層的問題,儲藏時會創建兩個提交,一個記錄 index 狀態、暫存的內容等,另一個紀錄 worktree 和其他的一些東西,如果你不在 apply 時加 index,Git 會把兩個一起銷毀,所以暫存區(stage)裡就空了)。 -## 未暫存(Unstaged)的內容 +## 未暫存(unstaged)的變化 -### 我想把未暫存的內容移動到一個新分支 +### 我想把未暫存的變化移動到新分支 ```sh $ git checkout -b my-branch ``` -### 我想把未暫存的內容移動到另一個已存在的分支 +### 我想把未暫存的變化移動到另一個已存在的分支 ```sh $ git stash @@ -287,9 +284,9 @@ $ git stash pop ``` -### 我想丟棄本地未提交的變化(uncommitted changes) +### 我想丟棄本地未提交的變化(uncommitted changes) -如果你只是想重設源(origin)和你本地(local)之間的一些提交(commit),你可以: +如果你只是想重設源(origin)和你本地(local)之間的一些提交(commit),你可以: ```sh # one commit @@ -302,25 +299,25 @@ $ git stash pop (main)$ git checkout -f ``` -重設某個特殊的文件, 你可以用檔案名做為參數: +如果要重設某個特定檔案,可以用檔案名做為引數: ```sh $ git reset filename ``` -### 我想丟棄某些未暫存的內容 +### 我想丟棄某些未暫存的變化 如果你想丟棄工作拷貝中的一部分內容,而不是全部。 -簽出(checkout)不需要的內容,保留需要的。 +簽出(checkout)不需要的內容,保留需要的。 ```sh $ git checkout -p # Answer y to all of the snippets you want to drop ``` -另外一個方法是使用 `stash`, Stash所有要保留下的內容, 重設工作拷貝, 重新應用保留的部分。 +另外一個方法是使用儲藏(stash),儲藏所有要保留的變化,重設工作拷貝,然後把儲藏彈出。 ```sh $ git stash -p @@ -329,7 +326,7 @@ $ git reset --hard $ git stash pop ``` -或者, stash 你不需要的部分, 然後stash drop。 +或者,儲藏你不需要的部分,然後丟棄儲藏(drop stash)。 ```sh $ git stash -p @@ -337,12 +334,12 @@ $ git stash -p $ git stash drop ``` -## 分支(Branches) +## 分支(branches) ### 我從錯誤的分支拉取了內容,或把內容拉取到了錯誤的分支 -這是另外一種使用 `git reflog` 情況,找到在這次錯誤拉(pull) 之前HEAD的指向。 +這是另外一種可以使用 `git reflog` 情況,找到在這次錯誤拉取(pull)之前 HEAD 的指向。 ```sh (main)$ git reflog @@ -350,7 +347,7 @@ ab7555f HEAD@{0}: pull origin wrong-branch: Fast-forward c5bc55a HEAD@{1}: checkout: checkout message goes here ``` -重設分支到你所需的提交(desired commit): +然後,重設分支到所需的提交: ```sh $ git reset --hard c5bc55a @@ -359,11 +356,11 @@ $ git reset --hard c5bc55a 完成。 -### 我想扔掉本地的提交(commit),以便我的分支與遠程的保持一致 +### 我想丟棄本地的提交(commit),以讓分支與遠端保持一致 -先確認你沒有推(push)你的內容到遠程。 +首先,確認你沒有推送(push)你的內容到遠端。 -`git status` 會顯示你領先(ahead)源(origin)多少個提交: +`git status` 會顯示本地領先(ahead)源(origin)多少個提交: ```sh (my-branch)$ git status @@ -373,69 +370,55 @@ $ git reset --hard c5bc55a # ``` -一種方法是: +一種方法是: ```sh (main)$ git reset --hard origin/my-branch ``` -### 我需要提交到一個新分支,但錯誤的提交到了main +### 我需要提交到一個新分支,但錯誤的提交到了 `main` -在main下創建一個新分支,不切換到新分支,仍在main下: +在 `main` 下創建一個新分支: ```sh (main)$ git branch my-branch ``` -把main分支重設到前一個提交: +把 `main` 重設到前一個提交: ```sh (main)$ git reset --hard HEAD^ ``` -`HEAD^` 是 `HEAD^1` 的簡寫,你可以透過指定要設置的`HEAD`來進一步重設。 +`HEAD^` 是 `HEAD^1` 的縮寫,你可以指定數字來進一步重設。或者,如果你不想使用 `HEAD^`,你可以指定一個提交(commit)的雜湊值(hash)(可以使用 `git log` 查看),如 `git reset --hard a13b85e`。 -或者, 如果你不想使用 `HEAD^`, 找到你想重設到的提交(commit)的hash(`git log` 能夠完成), 然後重設到這個hash。 使用`git push` 同步內容到遠程。 - -例如, main分支想重設到的提交的hash為`a13b85e`: - -```sh -(main)$ git reset --hard a13b85e -HEAD is now at a13b85e -``` - -簽出(checkout)剛才新建的分支繼續工作: +簽出(checkout)到剛才新建的分支繼續工作: ```sh (main)$ git checkout my-branch ``` -### 我想保留來自另外一個ref-ish的整個文件 +### 我想保留來自另外一個 ref-ish 的整個文件 -假設你正在做一個原型方案(原文為working spike (see note)), 有成百的內容,每個都工作得很好。現在, 你提交到了一個分支,保存工作內容: +假設你正在做一個原型方案(原文為 working spike),有成百上千的內容。當你提交到一個分支,儲存工作內容: ```sh (solution)$ git add -A && git commit -m "Adding all changes from this spike into one big commit." ``` -當你想要把它放到一個分支裡 (可能是`feature`, 或者 `develop`), 你關心是保持整個文件的完整,你想要一個大的提交分隔成比較小。 +當你想要把它放到一個分支裡(假設是 `develop`),你希望保持整個檔案的完整,並將大的提交分割成數個小的。 -假設你有: +假設這裡有: + * 分支 `solution`,擁有原型方案,領先 `develop` 分支。 + * 分支 `develop`,應用原型方案的一些內容。 - * 分支 `solution`, 擁有原型方案, 領先 `develop` 分支。 - * 分支 `develop`, 在這裡你應用原型方案的一些內容。 - -我去可以透過把內容拿到你的分支裡,來解決這個問題: +可以將內容放到那個分支中: ```sh (develop)$ git checkout solution -- file1.txt -``` - -這會把這個文件內容從分支 `solution` 拿到分支 `develop` 裡來: - -```sh +(develop)$ git status # On branch develop # Your branch is up-to-date with 'origin/develop'. # Changes to be committed: @@ -444,14 +427,14 @@ HEAD is now at a13b85e # modified: file1.txt ``` -然後, 正常提交。 +然後,普通地提交。 -Note: Spike solutions are made to analyze or solve the problem. These solutions are used for estimation and discarded once everyone gets clear visualization of the problem. ~ [Wikipedia](https://en.wikipedia.org/wiki/Extreme_programming_practices). +註:Spike solutions are made to analyze or solve the problem. These solutions are used for estimation and discarded once everyone gets clear visualization of the problem. ~ [Wikipedia](https://en.wikipedia.org/wiki/Extreme_programming_practices). -### 我把幾個提交(commit)提交到了同一個分支,而這些提交應該分布在不同的分支裡 +### 我把幾個提交(commit)提交到了同一個分支,而這些提交應該在不同的分支上 -假設你有一個`main`分支, 執行`git log`, 你看到你做過兩次提交: +假設在 `main` 分支,執行 `git log` 的結果如下: ```sh (main)$ git log @@ -475,73 +458,62 @@ Date: Tue Jul 21 01:12:48 2014 -0400 First commit ``` -讓我們用提交hash(commit hash)標記bug (`e3851e8` for #21, `5ea5173` for #14). - -首先, 我們把`main`分支重設到正確的提交(`a13b85e`): +要把 `e3851e8` 和 `5ea5173` 分別移到新的分支,首先,要把 `main` 分支重設到正確的提交(`a13b85e`): ```sh (main)$ git reset --hard a13b85e HEAD is now at a13b85e ``` -現在, 我們對 bug #21 創建一個新的分支: +新增一個分支: ```sh (main)$ git checkout -b 21 -(21)$ ``` -接著, 我們用 *cherry-pick* 把對bug #21的提交放入當前分支。 這意味著我們將應用(apply)這個提交(commit),僅僅這一個提交(commit),直接在HEAD上面。 +接著,然後挑揀(cherry-pick)提交到正確的分支上。這意味著我們將直接在 HEAD 上面應用(apply)這個提交。 ```sh (21)$ git cherry-pick e3851e8 ``` -這時候, 這裡可能會產生衝突, 參見[互動式 rebasing 章](#interactive-rebase) [**衝突節**](#merge-conflict) 解決衝突. +這可能會造成衝突(conflict),參見〈[互動式變基](#interactive-rebase)・[衝突](#merge-conflict)〉來解決衝突。 -再者, 我們為bug #14 創建一個新的分支, 也基於`main`分支 +同樣地,為 `5ea5173` 也創建一個分支,並把提交挑揀到其上: ```sh -(21)$ git checkout main (main)$ git checkout -b 14 -(14)$ -``` - -最後, 為 bug #14 執行 `cherry-pick`: - -```sh (14)$ git cherry-pick 5ea5173 ``` -### 我想刪除上遊(upstream)分支被刪除了的本地分支 -一旦你在github 上面合併(merge)了一個pull request, 你就可以刪除你fork裡被合併的分支。 如果你不準備繼續在這個分支裡工作, 刪除這個分支的本地拷貝會更乾淨,使你不會陷入工作分支和一堆陳舊分支的混亂之中。 +### 我想刪除上遊(upstream)刪除了的本地分支 + +比方說,在 GitHub 中,合併(merge)了拉取請求(pull request)後,就可以刪除掉分支。如果不準備繼續在這個分支上工作,刪除這個分支會使工作拷貝(working copy)更乾淨。 ```sh $ git fetch -p ``` -### 我不小心刪除了我的分支 +### 我不小心刪除了分支 -如果你定期推送到遠程, 多數情況下應該是安全的,但有些時候還是可能刪除了還沒有推到遠程的分支。 讓我們先創建一個分支和一個新的文件: +如果你定期推送(push)到遠端(remote),多數情況下應該是安全的,但有時可能刪除了還沒推送的分支。 + +為了模擬這種情況,首先,創建一個分支和一個檔案: ```sh (main)$ git checkout -b my-branch -(my-branch)$ git branch (my-branch)$ touch foo.txt (my-branch)$ ls README.md foo.txt ``` -添加文件並做一次提交 +加入變化並提交: ```sh (my-branch)$ git add . (my-branch)$ git commit -m 'foo.txt added' -(my-branch)$ foo.txt added - 1 files changed, 1 insertions(+) - create mode 100644 foo.txt (my-branch)$ git log commit 4e3cd85a670ced7cc17a2b5d8d3d809ac88d5012 @@ -557,7 +529,7 @@ Date: Tue Jul 29 13:14:46 2014 -0400 Fixes #6: Force pushing after amending commits ``` -現在我們切回到主(main)分支,‘不小心的’刪除`my-branch`分支 +現在,切回 `main` 分支,並「不小心」刪除了 `my-branch`: ```sh (my-branch)$ git checkout main @@ -569,7 +541,7 @@ Deleted branch my-branch (was 4e3cd85). oh noes, deleted my branch! ``` -在這時候你應該想起了`reflog`, 一個升級版的日誌,它儲存了倉庫(repo)裡面所有動作的歷史。 +你應該想起了 `reflog`,它記錄了所有動作。 ``` (main)$ git reflog @@ -578,7 +550,7 @@ oh noes, deleted my branch! 69204cd HEAD@{2}: checkout: moving from main to my-branch ``` -正如你所見,我們有一個來自刪除分支的提交hash(commit hash),接下來看看是否能恢覆刪除了的分支。 +如你所見,其中包含了刪除分支的提交的雜湊值(hash)。可以藉此把提交找回來: ```sh (main)$ git checkout -b my-branch-help @@ -589,39 +561,39 @@ HEAD is now at 4e3cd85 foo.txt added README.md foo.txt ``` -看! 我們把刪除的文件找回來了。 Git的 `reflog` 在rebasing出錯的時候也是同樣有用的。 +看!我們把遺失的檔案找回來了。Git 的 `reflog` 在變基(rebase)出錯時也同樣有用。 ### 我想刪除一個分支 -刪除一個遠程分支: +刪除一個遠端分支: ```sh (main)$ git push origin --delete my-branch ``` -你也可以: +或: ```sh (main)$ git push origin :my-branch ``` -刪除一個本地分支: +刪除一個本地分支: ```sh (main)$ git branch -D my-branch ``` -### 我想從別人正在工作的遠程分枝籤出(checkout)一個分支 +### 我想從別人正在工作的遠端分支簽出(checkout)一個分支 -首先, 從遠程拉取(fetch) 所有分支: +首先,從遠端獲取(fetch)所有分支: ```sh (main)$ git fetch --all ``` -假設你想要從遠程的`daves`分枝籤出到本地的`daves` +假設你想要從遠端的 `daves` 分支簽出到本地的 `daves`: ```sh (main)$ git checkout --track origin/daves @@ -629,25 +601,27 @@ Branch daves set up to track remote branch daves from origin. Switched to a new branch 'daves' ``` -(`--track` 是 `git checkout -b [branch] [remotename]/[branch]` 的簡寫) +(`--track` 是 `git checkout -b [branch] [remotename]/[branch]` 的縮寫。) -這樣就得到了一個`daves`分支的本地拷貝, 任何推過(pushed)的更新,遠程都能看到. +這樣就有 `daves` 的本地拷貝了。 -## Rebasing 和合併(Merging) +## 變基(rebase)與合併(merge) -### 我想撤銷rebase/merge +### 撤銷變基或合併 -你可以合併(merge)或rebase了一個錯誤的分支, 或者完成不了一個進行中的rebase/merge。 Git 在進行危險操作的時候會把原始的HEAD保存在一個叫ORIG_HEAD的變數裡, 所以要把分支恢覆到rebase/merge前的狀態是很容易的。 +你可能對一個錯誤的分支做了變基或合併,或者無法完成變基或合併。Git 在進行危險操作時,會將原本的 `HEAD` 存成 `ORIG_HEAD`,因此可以很容易的恢復到之前的狀態。 ```sh (my-branch)$ git reset --hard ORIG_HEAD ``` -### 我已經rebase過, 但是我不想強推(force push) +### 我做了變基,但是我不想強制推送(force push) -不幸的是,如果你想把這些變化(changes)反應到遠程分支上,你就必須得強推(force push)。 是因你快進(Fast forward)了提交,改變了Git歷史, 遠程分支不會接受變化(changes),除非強推(force push)。這就是許多人使用 merge 工作流, 而不是 rebasing 工作流的主要原因之一, 開發者的強推(force push)會使大的團隊陷入麻煩。使用時需要注意,一種安全使用 rebase 的方法是,不要把你的變化(changes)反映到遠程分支上, 而是按下面的做: +不幸的是,如果你想把變基的結果反映在遠端分支上,你必須強制推送(force push)。因為你改變了歷史,遠端不會接受使用快進(fast-forward),而必須強制推送。這就是許多人使用合併工作流程、而不是變基工作流程的主要原因之一,開發者的強制推送會使大團隊陷入麻煩。 + +一種安全的方式是,不要推送到遠端: ```sh (main)$ git checkout my-branch @@ -656,31 +630,33 @@ Switched to a new branch 'daves' (main)$ git merge --ff-only my-branch ``` -更多, 參見 [this SO thread](http://stackoverflow.com/questions/11058312/how-can-i-use-git-rebase-without-requiring-a-forced-push). +參見[此 StackOverflow 討論串](http://stackoverflow.com/questions/11058312/how-can-i-use-git-rebase-without-requiring-a-forced-push)。 -### 我需要組合(combine)幾個提交(commit) +### 我需要組合(combine)幾個提交(commit) -假設你的工作分支將會做對於 `main` 的pull-request。 一般情況下你不關心提交(commit)的時間戳,只想組合 *所有* 提交(commit) 到一個單獨的裡面, 然後重設(reset)重提交(recommit)。 確保主(main)分支是最新的和你的變化都已經提交了, 然後: +假設你的工作分支將對 `main` 分支做拉取請求(pull request)。 + +最簡單的情況下,不會關心提交的時間戳(timestamp),只想將所有的提交組合成一個單獨的提交,你可以重設(reset)和重新提交(recommit)。確保 `main` 是最新的,且你的變化都已經提交,然後: ```sh (my-branch)$ git reset --soft main (my-branch)$ git commit -am "New awesome feature" ``` -如果你想要更多的控制, 想要保留時間戳, 你需要做互動式rebase (interactive rebase): +如果你想保留更多控制、保留時間戳,你需要互動式變基(interactive rebase): ```sh (my-branch)$ git rebase -i main ``` -如果沒有相對的其它分支, 你將不得不相對自己的`HEAD` 進行 rebase。 例如:你想組合最近的兩次提交(commit), 你將相對於`HEAD~2` 進行rebase, 組合最近3次提交(commit), 相對於`HEAD~3`, 等等。 +如果沒有相對於其他分支,將不得不相對於 `HEAD` 變基。例如,要組合最近的兩次提交,需相對於 `HEAD~2` 變基,組合最近三次提交,則相對於 `HEAD~3`,以此類推。 ```sh (main)$ git rebase -i HEAD~2 ``` -在你執行了互動式 rebase的命令(interactive rebase command)後, 你將在你的編輯器裡看到類似下面的內容: +在執行了互動式變基的命令(interactive rebase command)後,你會在編輯器裡看到類似以下的內容: ```vim pick a9c8a1d Some refactoring @@ -707,11 +683,9 @@ pick e3851e8 another fix # Note that empty commits are commented out ``` -所有以 `#` 開頭的行都是注釋, 不會影響 rebase. +(以 `#` 開頭的行是註解,不影響變基。) -然後,你可以用任何上面命令列表的命令替換 `pick`, 你也可以透過刪除對應的行來刪除一個提交(commit)。 - -例如, 如果你想 **單獨保留最舊(first)的提交(commit),組合所有剩下的到第二個裡面**, 你就應該編輯第二個提交(commit)後面的每個提交(commit) 前的單字為 `f`: +你可以以註解中提到的命令替換 `pick`,也可以刪除一行來刪除對應的提交。例如,如果要保留最舊(first)的提交,並將其他組合成第二個提交,應該將第二個提交之後所有提交的命令改為 `f`: ```vim pick a9c8a1d Some refactoring @@ -720,7 +694,7 @@ f b729ad5 fixup f e3851e8 another fix ``` -如果你想組合這些提交(commit) **並重命名這個提交(commit)**, 你應該在第二個提交(commit)旁邊添加一個`r`,或者更簡單的用`s` 替代 `f`: +如果要組合並重新命名這個提交,應該在第二個提交加上 `r`,或使用 `s` 取代 `f`: ```vim pick a9c8a1d Some refactoring @@ -729,7 +703,7 @@ s b729ad5 fixup s e3851e8 another fix ``` -你可以在接下來彈出的文本提示框裡重命名提交(commit)。 +你可以在接著彈出的文字提示中重新命名那個提交: ```vim Newer, awesomer features @@ -742,75 +716,77 @@ Newer, awesomer features # Changes to be committed: # modified: README.md # - ``` -如果成功了, 你應該看到類似下面的內容: +應該會看到如下的成功訊息: ```sh (main)$ Successfully rebased and updated refs/heads/main. ``` -#### 安全合併(merging)策略 -`--no-commit` 執行合併(merge)但不自動提交, 給用戶在做提交前檢查和修改的機會。 `no-ff` 會為特性分支(feature branch)的存在過留下證據, 保持項目歷史一致。 +#### 安全合併的策略 + +`--no-commit` 選項會合併但不會自動提交,給使用者在提交前檢查和修改的機會。`--no-ff` 會留下功能分支(feature branch)存在過的證據,保持歷史一致。 ```sh (main)$ git merge --no-ff --no-commit my-branch ``` -#### 我需要將一個分支合併成一個提交(commit) +#### 我需要將一個分支合併成一個提交 ```sh (main)$ git merge --squash my-branch ``` -#### 我只想組合(combine)未推的提交(unpushed commit) +#### 我只想組合(combine)未推送的提交 -有時候,在將數據推向上遊之前,你有幾個正在進行的工作提交(commit)。這時候不希望把已經推(push)過的組合進來,因為其他人可能已經有提交(commit)引用它們了。 +假設在推送到上遊前,你有幾個正在進行的工作提交,這時候不希望把已推送的提交也組合進來,因為其他人可能已經有提交引用它們了。 ```sh (main)$ git rebase -i @{u} ``` -這會產生一次互動式的rebase(interactive rebase), 只會列出沒有推(push)的提交(commit), 在這個列表時進行reorder/fix/squash 都是安全的。 +這會進行一次互動式變基(interactive rebase),只會列出還沒推送的提交。對這些提交重新排序或做 squash、fixup 都是安全的。 -### 檢查是否分支上的所有提交(commit)都合併(merge)過了 +### 檢查分支上的所有提交是否都合併了 -檢查一個分支上的所有提交(commit)是否都已經合併(merge)到了其它分支, 你應該在這些分支的head(或任何 commits)之間做一次diff: +要檢查一個分支上的所有提交是否都已經合併進了其它分支,應該在這些分支的 `HEAD`(或任何提交)之間檢查差異: ```sh (main)$ git log --graph --left-right --cherry-pick --oneline HEAD...feature/120-on-scroll ``` -這會告訴你在一個分支裡有而另一個分支沒有的所有提交(commit), 和分支之間不共享的提交(commit)的列表。 另一個做法可以是: +這會顯示一個分支有而另一個分支沒有的提交,和分支之間不共享的提交的列表。 + +另一個方法是: ```sh (main)$ git log main ^feature/120-on-scroll --no-merges ``` -### 互動式rebase(interactive rebase)可能出現的問題 +### 互動式變基(interactive rebase)可能出現的問題 -#### 這個rebase 編輯螢幕出現'noop' +#### 編輯介面出現「noop」 + +如果你看到: -如果你看到的是這樣: ``` noop ``` -這意味著你rebase的分支和當前分支在同一個提交(commit)上, 或者 *領先(ahead)* 當前分支。 你可以嘗試: - -* 檢查確保主(main)分支沒有問題 -* rebase `HEAD~2` 或者更早 +表示變基的分支和目前分支在同一個提交,或領先(ahead)目前分支。你可以嘗試: + * 確保 `main` 分支沒有問題 + * 對 `HEAD~2` 或更早的提交變基 #### 有衝突的情況 -如果你不能成功的完成rebase, 你可能必須要解決衝突。 +如果不能成功的完成變基,你可能必須要解決衝突(resolve conflict)。 -首先執行 `git status` 找出哪些文件有衝突: +首先用 `git status` 檢查哪些檔案有衝突: ```sh (my-branch)$ git status @@ -822,7 +798,7 @@ Changes not staged for commit: modified: README.md ``` -在這個例子裡面, `README.md` 有衝突。 打開這個文件找到類似下面的內容: +在這個例子中,`README.md` 有衝突。打開衝突的檔案會看到類似下面的內容: ```vim <<<<<<< HEAD @@ -832,99 +808,100 @@ Changes not staged for commit: >>>>>>> new-commit ``` -你需要解決新提交的代碼(範例裡, 從中間`==`線到`new-commit`的地方)與`HEAD` 之間不一樣的地方. +你必須解決新提交的內容和 `HEAD` 中的內容的衝突。 -有時候這些合並非常複雜,你應該使用可視化的差異編輯器(visual diff editor): +有時候衝突非常複雜,你可以使用可視化差異編輯器(visual diff editor): ```sh (main*)$ git mergetool -t opendiff ``` -在你解決完所有衝突和測試過後, `git add` 變化了的(changed)文件, 然後用`git rebase --continue` 繼續rebase。 +解決所有衝突後,加入變化了的檔案,然後用 `git rebase --continue` 繼續變基: ```sh (my-branch)$ git add README.md (my-branch)$ git rebase --continue ``` -如果在解決完所有的衝突過後,得到了與提交前一樣的結果, 可以執行`git rebase --skip`。 +如果在解決所有衝突過後,得到了與提交前一樣的結果,可以使用 `git rebase --skip`。 -任何時候你想結束整個rebase 過程,回來rebase前的分支狀態, 你可以做: +如果想放棄變基,回到之前的狀態,可以在任何時候用: ```sh (my-branch)$ git rebase --abort ``` -## Stash +## 儲藏(stash) -### 暫存所有改動 +### 儲藏所有變化 -暫存你工作目錄下的所有改動 +儲藏工作目錄下所有變化: ```sh $ git stash ``` -你可以使用`-u`來排除一些文件 +可以使用 `-u` 選項排除一些檔案: ```sh $ git stash -u ``` -### 暫存指定文件 +### 儲藏指定檔案 -假設你只想暫存某一個文件 +儲藏一個檔案: ```sh $ git stash push working-directory-path/filename.ext ``` -假設你想暫存多個文件 +儲藏多個檔案: ```sh $ git stash push working-directory-path/filename1.ext working-directory-path/filename2.ext ``` -### 暫存時記錄消息 - -這樣你可以在`list`時看到它 +### 儲藏時附加訊息 ```sh $ git stash save ``` + 或 + ```sh $ git stash push -m ``` - -### 使用某個指定暫存 -首先你可以查看你的`stash`記錄 +如此可以在使用 `stash list` 時看到訊息。 + + +### 應用(apply)指定儲藏 + +可以先列出擁有的儲藏: ```sh $ git stash list ``` -然後你可以`apply`某個`stash` +然後,將以下命令的 `n` 替換成儲藏在堆疊中的位置(最上方為 `0`),應用指定儲藏: ```sh $ git stash apply "stash@{n}" ``` -此處, 'n'是`stash`在棧中的位置,最上層的`stash`會是0 - -除此之外,也可以使用時間標記(假如你能記得的話)。 +除此之外,也可以使用時間標記(假如你能記住的話),如: ```sh $ git stash apply "stash@{2.hours.ago}" ``` -### 暫存時保留未暫存的內容 +### 儲藏時保留未暫存的內容 -你需要手動create一個`stash commit`, 然後使用`git stash store`。 +你需要先手動創建一個儲藏提交,然後使用 `git stash store`。 ```sh $ git stash create @@ -932,7 +909,7 @@ $ git stash store -m "commit-message" CREATED_SHA1 ``` -## 雜項(Miscellaneous Objects) +## 雜項 ### 複製所有子模組 @@ -941,14 +918,14 @@ $ git stash store -m "commit-message" CREATED_SHA1 $ git clone --recursive git://github.com/foo/bar.git ``` -如果已經複製了: +如果已經複製了: ```sh $ git submodule update --init --recursive ``` -### 刪除標籤(tag) +### 刪除標籤(tag) ```sh $ git tag -d @@ -956,30 +933,28 @@ $ git push :refs/tags/ ``` -### 恢覆已刪除標籤(tag) +### 恢復已刪除標籤(tag) -如果你想恢覆一個已刪除標籤(tag), 可以按照下面的步驟: 首先, 需要找到無法訪問的標籤(unreachable tag): +如果想恢復一個已刪除標籤,首先,找到無法觸及的標籤(unreachable tag): ```sh $ git fsck --unreachable | grep tag ``` -記下這個標籤(tag)的hash,然後用Git的 [update-ref](http://git-scm.com/docs/git-update-ref): +記下這個標籤的雜湊值,然後用 Git 的 [`update-ref`](http://git-scm.com/docs/git-update-ref): ```sh $ git update-ref refs/tags/ ``` -這時你的標籤(tag)應該已經恢覆了。 - -### 已刪除補丁(patch) +### 已刪除補丁(patch) -如果某人在 GitHub 上給你發了一個pull request, 但是然後他刪除了他自己的原始 fork, 你將沒辦法複製他們的提交(commit)或使用 `git am`。在這種情況下, 最好手動的查看他們的提交(commit),並把它們拷貝到一個本地新分支,然後做提交。 +如果有人在 GitHub 上向你提出了拉取請求(pull request),但他接著刪除了他的分叉(fork),你無法複製他的提交或使用 `git am`。在這種情況下,最好手動的查看他們的提交,把它們拷貝到一個本地新分支,然後提交。 -做完提交後, 再修改作者,參見[變更作者](#commit-wrong-author)。 然後, 應用變化, 再發起一個新的pull request。 +最後,再修改作者,參見[〈變更作者〉](#commit-wrong-author)。然後,應用變化,再發起一個新的拉取請求。 -## 跟蹤文件(Tracking Files) +## 追蹤檔案(tracking files) ### 我只想改變一個檔案名字的大小寫,而不修改內容 @@ -989,18 +964,18 @@ $ git update-ref refs/tags/ ``` -### 我想從Git刪除一個文件,但保留該文件 +### 我想從 Git 刪除一個檔案,但保留該檔案 ```sh (main)$ git rm --cached log.txt ``` -## 配置(Configuration) +## 組態(configuration) -### 我想給一些Git命令添加別名(alias) +### 我想為 Git 命令設定別名(alias) -在 OS X 和 Linux 下, 你的 Git的配置文件儲存在 ```~/.gitconfig```。我在```[alias]``` 部分添加了一些快捷別名(和一些我容易拼寫錯誤的),如下: +在 OS X 和 Linux 下,Git 的組態檔案儲存在 `~/.gitconfig`。可以在 `[alias]` 部分設定一些快捷別名(以及容易拼錯的),如: ```vim [alias] @@ -1026,26 +1001,26 @@ $ git update-ref refs/tags/ ``` -### 我想快取一個倉庫(repository)的使用者名稱和密碼 +### 我想快取一個倉庫(repository)的使用者名稱和密碼 -你可能有一個倉庫需要授權,這時你可以快取使用者名稱和密碼,而不用每次推/拉(push/pull)的時候都輸入,Credential helper能幫你。 +假設有一個倉庫需要授權,這時你可以快取使用者名稱和密碼,而不用每次推送和拉取時都輸入一次: ```sh $ git config --global credential.helper cache -# Set git to use the credential memory cache +# Set Git to use the credential memory cache. ``` ```sh $ git config --global credential.helper 'cache --timeout=3600' -# Set the cache to timeout after 1 hour (setting is in seconds) +# Set the cache to timeout after 1 hour (setting is in seconds). ``` -## 我不知道我做錯了些什麼 +## 我不知道我做錯了什麼 -你把事情搞砸了:你 `重設(reset)` 了一些東西, 或者你合併了錯誤的分支, 亦或你強推了後找不到你自己的提交(commit)了。有些時候, 你一直都做得很好, 但你想回到以前的某個狀態。 +如果你把事情搞砸了:你錯誤地重設、合併,或強制推送後找不到自己的提交了,抑或你做得很好,但你想回到以前的某個狀態。 -這就是 `git reflog` 的目的, `reflog` 記錄對分支頂端(the tip of a branch)的任何改變, 即使那個頂端沒有被任何分支或標籤引用。基本上, 每次HEAD的改變, 一條新的紀錄就會增加到`reflog`。遺憾的是,這只對本地分支起作用,且它只跟蹤動作 (例如,不會跟蹤一個沒有被記錄的文件的任何改變)。 +這就是 `git reflog` 的目的,`reflog` 記錄對分支頂端(the tip of a branch)的任何改變,即使沒有任何分支或標籤參考那個頂端。基本上,只要 `HEAD` 改變,`reflog` 就會記錄下來。遺憾的是,這只對本地分支起作用,且它只追蹤動作(例如,不會追蹤一個沒被記錄的檔案的任何改變)。 ```sh (main)$ git reflog @@ -1054,45 +1029,44 @@ $ git config --global credential.helper 'cache --timeout=3600' c10f740 HEAD@{2}: checkout: moving from main to 2.2 ``` -上面的reflog展示了從main分枝籤出(checkout)到2.2 分支,然後再簽回。 那裡,還有一個硬重設(hard reset)到一個較舊的提交。最新的動作出現在最上面以 `HEAD@{0}`標識. +上面的 `reflog` 顯示了曾經從 `main` 分支簽出到 `2.2` 分支,然後再簽出回去,還有硬重設到一個較舊的提交。最新的動作出現在最上面,並以 `HEAD@{0}` 標示。 -如果事實證明你不小心回移(move back)了提交(commit), reflog 會包含你不小心回移前main上指向的提交(0254ea7)。 +如果你不小心回移(move back)了提交,`reflog` 會包含回移前 `main` 參考的提交(在這個例子中是 `0254ea7`)。只要硬重設就能恢復到之前的狀態,這提供了歷史不小心被變更時的安全網。 ```sh $ git reset --hard 0254ea7 ``` -然後使用git reset就可以把main改回到之前的commit,這提供了一個在歷史被意外更改情況下的安全網。 +摘自[這裡](https://www.atlassian.com/git/tutorials/rewriting-history/git-reflog)。 -([摘自](https://www.atlassian.com/git/tutorials/rewriting-history/git-reflog)). +# 其他資源 -# 其它資源(Other Resources) +## 書籍 -## 書(Books) +* [Pro Git](https://git-scm.com/book/en/v2)——Scott Chacon 的傑出書籍 +* [Git Internals](https://github.com/pluralsight/git-internals-pdf)——Scott Chacon 的另一本傑出書籍 -* [Pro Git](https://git-scm.com/book/en/v2) - Scott Chacon's excellent git book -* [Git Internals](https://github.com/pluralsight/git-internals-pdf) - Scott Chacon's other excellent git book +## 教學 -## 教學(Tutorials) - -* [Learn Git branching](https://learngitbranching.js.org/) 一個基於網頁的互動式 branching/merging/rebasing 教學 +* [Learn Git branching](https://learngitbranching.js.org/)——一個基於網頁的互動式分支、合併、變基教學 * [Getting solid at Git rebase vs. merge](https://medium.com/@porteneuve/getting-solid-at-git-rebase-vs-merge-4fa1a48c53aa) -* [git-workflow](https://github.com/asmeurer/git-workflow) - [Aaron Meurer](https://github.com/asmeurer)的怎麼使用Git為開源倉庫貢獻 -* [GitHub as a workflow](http://hugogiraudel.com/2015/08/13/github-as-a-workflow/) - 使用GitHub做為工作流的趣事, 尤其是空PRs +* [git-workflow](https://github.com/asmeurer/git-workflow)——[Aaron Meurer](https://github.com/asmeurer) 的怎麼使用 Git 開源貢獻 +* [GitHub as a workflow](http://hugogiraudel.com/2015/08/13/github-as-a-workflow/)——GitHub 作為工作流程的趣事,特別是空拉取請求 -## 腳本和工具(Scripts and Tools) +## 腳本和工具 -* [firstaidgit.io](http://firstaidgit.io/) 一個可搜索的最常被問到的Git的問題 -* [git-extra-commands](https://github.com/unixorn/git-extra-commands) - 一堆有用的額外的Git腳本 -* [git-extras](https://github.com/tj/git-extras) - GIT 工具集 -- repo summary, repl, changelog population, author commit percentages and more -* [git-fire](https://github.com/qw3rtman/git-fire) - git-fire 是一個 Git 插件,用於幫助在緊急情況下添加所有當前文件, 做提交(committing), 和推(push)到一個新分支(阻止合併衝突)。 -* [git-tips](https://github.com/git-tips/tips) - Git小提示 -* [git-town](https://github.com/Originate/git-town) - 通用,高級Git工作流支持! http://www.git-town.com +* [firstaidgit.io](http://firstaidgit.io/)——一個可搜尋的 Git 常見問題集 +* [git-extra-commands](https://github.com/unixorn/git-extra-commands)——一堆有用的額外 Git 腳本 +* [git-extras](https://github.com/tj/git-extras)——Git 工具集,倉庫概要、repl、變更記錄、提交百分比和更多 +* [git-fire](https://github.com/qw3rtman/git-fire)——git-fire 是一個 Git 插件,用於在緊急情況下幫助加入目前所有檔案、提交、推送到一個新分支(防止合併衝突)。 +* [git-tips](https://github.com/git-tips/tips)——Git 小撇步 +* [git-town](https://github.com/Originate/git-town)——通用、高級 Git 工作流程支援! http://www.git-town.com -## GUI用戶端(GUI Clients) -* [GitKraken](https://www.gitkraken.com/) - 豪華的Git用戶端 Windows, Mac & Linux -* [git-cola](https://git-cola.github.io/) - 另外一個Git用戶端 Windows & OS X -* [GitUp](https://github.com/git-up/GitUp) - 一個新的Git用戶端,在處理Git的複雜性上有自己的特點 -* [gitx-dev](https://rowanj.github.io/gitx/) - 圖形化的Git用戶端 OS X -* [Source Tree](https://www.sourcetreeapp.com/) - 免費的圖形化Git用戶端 Windows & OS X -* [Tower](http://www.git-tower.com/) - 圖形化Git用戶端 OS X(付費) +## GUI 客戶端 + +* [GitKraken](https://www.gitkraken.com/)——豪華的 Git 客戶端,適用於 Windows、Mac、Linux +* [git-cola](https://git-cola.github.io/)——又一個 Git 客戶端,適用於 Windows、OS X +* [GitUp](https://github.com/git-up/GitUp)——一個新的 Git 客戶端,在解決 Git 的複雜問題上有自己的特點 +* [gitx-dev](https://rowanj.github.io/gitx/)——又一個圖形化的 Git 客戶端,適用於 OS X +* [Source Tree](https://www.sourcetreeapp.com/)——簡單而強大的免費 Git GUI 客戶端,適用於 Windows、OS X +* [Tower](http://www.git-tower.com/)——圖形化 Git 客戶端,適用於 OS X(付費)