zh_tw/basic.txt

   1 == 基本技巧 ==
   2
   3 與其一頭紮進Git命令的海洋中，不如來點基本的例子試試手。它們簡單而且實用。實際
   4 上，在開始使用Git的頭幾個月，我所用的從來沒超出本章介紹的內容。
   5
   6 === 保存狀態 ===
   7
   8 要不來點猛的？在做之前，先為當前目錄所有檔案做個快照，使用：
   9
  10  $ git init
  11  $ git add .
  12  $ git commit -m "My first backup"
  13
  14 現在如果你的編輯亂了套，恢復之前的版本：
  15
  16  $ git reset --hard
  17
  18 再次保存狀態：
  19
  20  $ git commit -a -m "Another backup"
  21
  22 === 添加、刪除、重命名 ===
  23
  24 以上命令將只跟蹤你第一次運行 *git add* 命令時就已經存在的檔案。如果要添加新文
  25 件或子目錄，你需要告訴Git：
  26
  27  $ git add readme.txt Documentation
  28
  29 類似，如果你想讓Git忘記某些檔案：
  30
  31  $ git rm kludge.h obsolete.c
  32  $ git rm -r incriminating/evidence/
  33
  34 這些檔案如果還沒刪除，Git刪除它們。
  35
  36 重命名檔案和先刪除舊檔案，再添加新檔案的一樣。也有一個快捷方式 *git mv* ，和
  37 *mv* 命令的用法一樣。例如：
  38
  39  $ git mv bug.c feature.c
  40
  41 === 進階撤銷/重做 ===
  42
  43 有時候你只想把某個時間點之後的所有改動都回滾掉，因為這些的改動是不正確的。那
  44 麼：
  45
  46  $ git log
  47
  48 來顯示最近提交列表，以及他們的SHA1哈希值:
  49
  50 ----------------------------------
  51 commit 766f9881690d240ba334153047649b8b8f11c664
  52 Author: Bob <bob@example.com>
  53 Date:   Tue Mar 14 01:59:26 2000 -0800
  54
  55     Replace printf() with write().
  56
  57 commit 82f5ea346a2e651544956a8653c0f58dc151275c
  58 Author: Alice <alice@example.com>
  59 Date:   Thu Jan 1 00:00:00 1970 +0000
  60
  61     Initial commit.
  62 ----------------------------------
  63
  64 哈希值的前幾個字元足夠確定一個提交；也可以拷貝粘貼完整的哈希值，鍵入：
  65
  66  $ git reset --hard 766f
  67
  68 來恢復到一個指定的提交狀態，並從記錄裡永久抹掉所有比該記錄新一些的提交。
  69
  70 另一些時候你想簡單地跳到一個舊狀態。這種情況，鍵入：
  71
  72  $ git checkout 82f5
  73
  74 這個操作將把你帶回過去，同時也保留較新提交。然而，像科幻電影裡時光旅行一樣，
  75 如果你這時編輯並提交的話，你將身處另一個現實裡，因為你的動作與開始時相比是不
  76 同的。
  77
  78 這另一個現實叫作“分支”（branch），之後 <<branch,我們會對這點多討論一些>>。
  79 至于現在，只要記住：
  80
  81  $ git checkout master
  82
  83 會把你帶到當下來就可以了。另外，為避免Git的抱怨，應該在每次運行checkout之前提
  84 交（commit）或重置（reset）你的改動。
  85
  86 還以電腦遊戲作為類比：
  87
  88 - *`git reset --hard`*: 加載一個舊記錄並刪除所有比之新的記錄。
  89
  90 - *`git checkout`*: 加載一個舊記錄，但如果你在這個記錄上玩，遊戲狀態將偏離第
  91   一輪的較新狀態。你現在打的所有遊戲記錄會在你剛進入的、代表另一個真實的分支
  92   裡。<<branch,我們稍後論述>>。
  93
  94 你可以選擇只恢復特定檔案和目錄，通過將其加在命令之後：
  95
  96  $ git checkout 82f5 some.file another.file
  97
  98 小心，這種形式的 *checkout* 會不聲不響地覆蓋檔案。為阻止意外發生，在運行任何
  99 checkout命令之前做提交，尤其在初學Git的時候。通常，任何時候你覺得對運行某個命
 100 令不放心，無論Git命令還是不是Git命令，就先運行一下 *git commit -a* 。
 101
 102 不喜歡拷貝站題哈希值？那就用：
 103
 104  $ git checkout :/"My first b"
 105
 106 來跳到以特定字元串開頭的提交。你也可以回到倒數第五個保存狀態：
 107
 108  $ git checkout master~5
 109
 110 === 撤銷 ===
 111
 112 在法庭上，事件可以從法庭記錄裡敲出來。同樣，你可以檢出特定提交以撤銷。
 113
 114  $ git commit -a
 115  $ git revert 1b6d
 116
 117 講撤銷給定哈希值的提交。本撤銷被記錄為一個新的提交，你可以通過運行 *git log*
 118 來確認這一點。
 119
 120 === 變更日誌生成 ===
 121
 122 一些項目要求生成變更日誌http://en.wikipedia.org/wiki/Changelog[changelog]. 生
 123 成一個，通過鍵入：
 124
 125  $ git log > ChangeLog
 126
 127 === 下載檔案 ===
 128
 129 得到一個由Git管理的項目的拷貝，通過鍵入：
 130
 131  $ git clone git://server/path/to/files
 132
 133 例如，得到我用來創建該站的所有檔案：
 134
 135  $ git clone git://git.or.cz/gitmagic.git
 136
 137 我們很快會對 *clone* 命令談的很多。
 138
 139 === 到最新 ===
 140
 141 如果你已經使用 *git clone* 命令得到了一個項目的一份拷貝，你可以更新到最新版，
 142 通過：
 143
 144  $ git pull
 145
 146
 147 === 快速發佈 ===
 148
 149 假設你寫了一個腳本，想和他人分享。你可以只告訴他們從你的計算機下載，但如果此
 150 時你正在改進你的腳本，或加入試驗性質的改動，他們下載了你的腳本，他們可能由此
 151 陷入困境。當然，這就是發佈周期存在的原因。開發人員可能頻繁進行項目修改，但他
 152 們只在他們覺得代碼可以見人的時候才擇時發佈。
 153
 154 用Git來完成這項，需要進入你的腳本所在目錄：
 155
 156  $ git init
 157  $ git add .
 158  $ git commit -m "First release"
 159
 160 然後告訴你的用戶去運行：
 161
 162  $ git clone your.computer:/path/to/script
 163
 164 來下載你的腳本。這要假定他們有ssh訪問權限。如果沒有，需要運行 *git daemon* 並
 165 告訴你的用戶去運行：
 166
 167  $ git clone git://your.computer/path/to/script
 168
 169 從現在開始，每次你的腳本準備好發佈時，就運行：
 170
 171  $ git commit -a -m "Next release"
 172
 173 並且你的用戶可以通過進入包含你腳本的目錄，並鍵入下列命令，來更新他們的版本：
 174
 175  $ git pull
 176
 177 你的用戶永遠也不會取到你不想讓他們看到的腳本版本。顯然這個技巧對所有的東西都
 178 是可以，不僅是對腳本。
 179
 180
 181 === 我們已經做了什麼？ ===
 182
 183 找出自從上次提交之後你已經做了什麼改變：
 184
 185  $ git diff
 186
 187 或者自昨天的改變：
 188
 189  $ git diff "@{yesterday}"
 190
 191 或者一個特定版本與倒數第二個變更之間：
 192
 193  $ git diff 1b6d "master~2"
 194
 195 輸出結果都是補丁格式，可以用 *git apply* 來把補丁打上。也可以試一下：
 196
 197  $ git whatchanged --since="2 weeks ago"
 198
 199 我也經常用http://sourceforge.net/projects/qgit[qgit] 瀏覽歷史, 因為他的圖形界
 200 面很養眼，或者 http://jonas.nitro.dk/tig/[tig] ，一個文本界面的東西，很慢的網
 201 絡狀況下也工作的很好。也可以安裝web 伺服器，運行 *git instaweb* ，就可以用任
 202 何瀏覽器瀏覽了。
 203
 204 === 練習 ===
 205
 206 比方A，B，C，D是四個連續的提交，其中B與A一樣，除了一些檔案刪除了。我們想把這
 207 些刪除的檔案加回D。我們如何做到這個呢？
 208
 209 至少有三個解決方案。假設我們在D：
 210
 211   1. A與B的差別是那些刪除的檔案。我們可以創建一個補丁代表這些差別，然後吧補丁
 212      打上：
 213
 214    $ git diff B A | git apply
 215
 216   2. 既然這些檔案存在A，我們可以把它們拿出來：
 217
 218    $ git checkout A foo.c bar.h
 219
 220   3. 我們可以把從A到B的變化視為可撤銷的變更：
 221
 222    $ git revert B
 223
 224 哪個選擇最好？這取決於你的喜好。利用Git滿足自己需求是容易，經常還有多個方法。