現在我們手上已經有了一個真實項目的 Git 倉庫，并從這個倉庫中取出了所有文件的工作拷貝。接下來，對這些文件作些修改，在完成了一個階段的目標之后，提交本次更新到倉庫。 請記住，工作目錄下面的所有文件都不外乎這兩種狀態：已跟蹤或未跟蹤。已跟蹤的文件是指本來就被納入版本控制管理的文件，在上次快照中有它們的記錄，工作一段時間后，它們的狀態可能是未更新，已修改或者已放入暫存區。而所有其他文件都屬于未跟蹤文件。它們既沒有上次更新時的快照，也不在當前的暫存區域。初次克隆某個倉庫時，工作目錄中的所有文件都屬于已跟蹤文件，且狀態為未修改。 在編輯過某些文件之后，Git 將這些文件標為已修改。我們逐步把這些修改過的文件放到暫存區域，直到最后一次性提交所有這些暫存起來的文件，如此重復。所以使用 Git 時的文件狀態變化周期如圖 2-1 所示。  圖 2-1. 文件的狀態變化周期 ## 檢查當前文件狀態 要確定哪些文件當前處于什么狀態，可以用 `git status` 命令。如果在克隆倉庫之后立即執行此命令，會看到類似這樣的輸出： ~~~ $ git status On branch master nothing to commit, working directory clean ~~~ 這說明你現在的工作目錄相當干凈。換句話說，所有已跟蹤文件在上次提交后都未被更改過。此外，上面的信息還表明，當前目錄下沒有出現任何處于未跟蹤的新文件，否則 Git 會在這里列出來。最后，該命令還顯示了當前所在的分支是 master，這是默認的分支名稱，實際是可以修改的，現在先不用考慮。下一章我們就會詳細討論分支和引用。 現在讓我們用 vim 創建一個新文件 README，保存退出后運行 git status 會看到該文件出現在未跟蹤文件列表中： ~~~ $ vim README $ git status On branch master Untracked files: (use "git add <file>..." to include in what will be committed) README nothing added to commit but untracked files present (use "git add" to track) ~~~ 在狀態報告中可以看到新建的README文件出現在“`Untracked files`”下面。未跟蹤的文件意味著Git在之前的快照（提交）中沒有這些文件；Git 不會自動將之納入跟蹤范圍，除非你明明白白地告訴它“我需要跟蹤該文件”，因而不用擔心把臨時文件什么的也歸入版本管理。不過現在的例子中，我們確實想要跟蹤管理 README 這個文件。 ## 跟蹤新文件 使用命令 `git add` 開始跟蹤一個新文件。所以，要跟蹤 README 文件，運行： `$ git add README` 此時再運行 git status 命令，會看到 README 文件已被跟蹤，并處于暫存狀態： ~~~ $ git status On branch master Changes to be committed: (use "git reset HEAD <file>..." to unstage) new file: README ~~~ 只要在 “Changes to be committed” 這行下面的，就說明是已暫存狀態。如果此時提交，那么該文件此時此刻的版本將被留存在歷史記錄中。你可能會想起之前我們使用 git init 后就運行了 git add 命令，開始跟蹤當前目錄下的文件。在 git add 后面可以指明要跟蹤的文件或目錄路徑。如果是目錄的話，就說明要遞歸跟蹤該目錄下的所有文件。（譯注：其實 git add 的潛臺詞就是把目標文件快照放入暫存區域，也就是 add file into staged area，同時未曾跟蹤過的文件標記為需要跟蹤。這樣就好理解后續 add 操作的實際意義了。） ## 暫存已修改文件 現在我們修改下之前已跟蹤過的文件 benchmarks.rb，然后再次運行 status 命令，會看到這樣的狀態報告： ~~~ $ git status On branch master Changes to be committed: (use "git reset HEAD <file>..." to unstage) new file: README Changes not staged for commit: (use "git add <file>..." to update what will be committed) (use "git checkout -- <file>..." to discard changes in working directory) modified: benchmarks.rb ~~~ 文件 benchmarks.rb 出現在 “Changes not staged for commit” 這行下面，說明已跟蹤文件的內容發生了變化，但還沒有放到暫存區。要暫存這次更新，需要運行 git add 命令（這是個多功能命令，根據目標文件的狀態不同，此命令的效果也不同：可以用它開始跟蹤新文件，或者把已跟蹤的文件放到暫存區，還能用于合并時把有沖突的文件標記為已解決狀態等）。現在讓我們運行 git add 將 benchmarks.rb 放到暫存區，然后再看看 git status 的輸出： ~~~ $ git add benchmarks.rb $ git status On branch master Changes to be committed: (use "git reset HEAD <file>..." to unstage) new file: README modified: benchmarks.rb ~~~ 現在兩個文件都已暫存，下次提交時就會一并記錄到倉庫。假設此時，你想要在 benchmarks.rb 里再加條注釋，重新編輯存盤后，準備好提交。不過且慢，再運行 git status 看看： ~~~ $ vim benchmarks.rb $ git status On branch master Changes to be committed: (use "git reset HEAD <file>..." to unstage) new file: README modified: benchmarks.rb Changes not staged for commit: (use "git add <file>..." to update what will be committed) (use "git checkout -- <file>..." to discard changes in working directory) modified: benchmarks.rb ~~~ 怎么回事？ benchmarks.rb 文件出現了兩次！一次算未暫存，一次算已暫存，這怎么可能呢？好吧，實際上 Git 只不過暫存了你運行 git add 命令時的版本，如果現在提交，那么提交的是添加注釋前的版本，而非當前工作目錄中的版本。所以，運行了 git add 之后又作了修訂的文件，需要重新運行 git add 把最新版本重新暫存起來： ~~~ $ git add benchmarks.rb $ git status On branch master Changes to be committed: (use "git reset HEAD <file>..." to unstage) new file: README modified: benchmarks.rb ~~~ ## 忽略某些文件 一般我們總會有些文件無需納入 Git 的管理，也不希望它們總出現在未跟蹤文件列表。通常都是些自動生成的文件，比如日志文件，或者編譯過程中創建的臨時文件等。我們可以創建一個名為 `.gitignore` 的文件，列出要忽略的文件模式。來看一個實際的例子： ~~~ $ cat .gitignore *.[oa] *~ ~~~ 第一行告訴 Git 忽略所有以 .o 或 .a 結尾的文件。一般這類對象文件和存檔文件都是編譯過程中出現的，我們用不著跟蹤它們的版本。第二行告訴 Git 忽略所有以波浪符（~）結尾的文件，許多文本編輯軟件（比如 Emacs）都用這樣的文件名保存副本。此外，你可能還需要忽略 log，tmp 或者 pid 目錄，以及自動生成的文檔等等。要養成一開始就設置好 `.gitignore` 文件的習慣，以免將來誤提交這類無用的文件。 文件` .gitignore` 的格式規范如下： * 所有空行或者以注釋符號 ＃ 開頭的行都會被 Git 忽略。 * 可以使用標準的 glob 模式匹配。 * 匹配模式最后跟反斜杠（/）說明要忽略的是目錄。 * 要忽略指定模式以外的文件或目錄，可以在模式前加上驚嘆號（!）取反。 所謂的 glob 模式是指 shell 所使用的簡化了的正則表達式。星號（*）匹配零個或多個任意字符；[abc] 匹配任何一個列在方括號中的字符（這個例子要么匹配一個 a，要么匹配一個 b，要么匹配一個 c）；問號（?）只匹配一個任意字符；如果在方括號中使用短劃線分隔兩個字符，表示所有在這兩個字符范圍內的都可以匹配（比如 [0-9] 表示匹配所有 0 到 9 的數字）。 我們再看一個 .gitignore 文件的例子： ~~~ * 此為注釋 – 將被 Git 忽略 * 忽略所有 .a 結尾的文件 *.a * 但 lib.a 除外 !lib.a * 僅僅忽略項目根目錄下的 TODO 文件，不包括 subdir/TODO /TODO * 忽略 build/ 目錄下的所有文件 build/ * 會忽略 doc/notes.txt 但不包括 doc/server/arch.txt doc/*.txt * ignore all .txt files in the doc/ directory doc/**/*.txt ~~~ > A `**/` pattern is available in Git since version 1.8.2. ## 查看已暫存和未暫存的更新 實際上` git status` 的顯示比較簡單，僅僅是列出了修改過的文件，如果要查看具體修改了什么地方，可以用`git diff` 命令。稍后我們會詳細介紹 `git diff`，不過現在，它已經能回答我們的兩個問題了：當前做的哪些更新還沒有暫存？有哪些更新已經暫存起來準備好了下次提交？ `git diff `會使用文件補丁的格式顯示具體添加和刪除的行。 假如再次修改 README 文件后暫存，然后編輯 `benchmarks.rb` 文件后先別暫存，運行 `status `命令將會看到： ~~~ $ git status On branch master Changes to be committed: (use "git reset HEAD <file>..." to unstage) new file: README Changes not staged for commit: (use "git add <file>..." to update what will be committed) (use "git checkout -- <file>..." to discard changes in working directory) modified: benchmarks.rb ~~~ 要查看尚未暫存的文件更新了哪些部分，不加參數直接輸入 `git diff`： ~~~ $ git diff diff --git a/benchmarks.rb b/benchmarks.rb index 3cb747f..da65585 100644 --- a/benchmarks.rb +++ b/benchmarks.rb @@ -36,6 +36,10 @@ def main ~~~