分享到plurk 分享到twitter 分享到facebook

版本 cad492762d49144acc8747d01369f65e4e0e7a65

git

Changes from cad492762d49144acc8747d01369f65e4e0e7a65 to current

---
title: Git
categories: 版本控制
...

簡介
====

關於 git 的簡介可參考 Wikipedia: `Git<http://zh.wikipedia.org/wiki/Git>`_
關於 git 的簡介可參考 Wikipedia: [Git](http://zh.wikipedia.org/wiki/Git)


檔案在git的旅程
--------------

![](/git_file_status.PNG)

- **untracked**:檔案一開始都在這個狀態。
- **unmodified**:經由指令將``untracked``的檔案加入追蹤,或是,``staged``狀態的檔案經由commit,會到這個狀態。另外在這狀態的檔案可以藉由指令來取消追蹤。
- **modified**:檔案只要有改變就會到這個狀態,無論是在``unmodified``或是``staged``狀態。藉由指令可以放棄這些變更,回到之前的狀態。
- **staged**:在這個狀態的檔案,通常就是要準備要提交到新的版本中了。在此狀態的檔案一經過更改就會回到``modified``狀態。

------------------------------------------------------

安裝
====

在 Ubuntu/Debian 上,``sudo apt-get install git-core``

------------------------------------------------------

簡單操作
=======

初始化
-----

使用 ``git init`` 可在目前的目錄下初始化一個 git repository。

若需要建立一個沒有工作目錄 (working directory) 的 repository,可以使用 ``git init --bare`` 來初始化,所建立的 repository 僅有 git 容器內容,通常用於 repository server。

將檔案加入追蹤
------------
在工作目錄 (working directory) 下,git 不會自動追蹤新建立的檔案,必須透過 ``git add`` 指令先將檔案納入容器索引 (index) 才能 commit 進版本庫中。


在一個新的版本庫中新增一個檔案,並使用 ``git status`` 查看版本庫狀態。Git 會提示發現新的檔案,但是不會自動列入追蹤。

.. code-block:: prettyprint

```
    $ echo "Hellow World" > new.txt
    $ git status
    # On branch master
    #
    # Initial commit
    #
    # Untracked files:
    #   (use "git add <file>..." to include in what will be committed)
    #
    #       new.txt
    nothing added to commit but untracked files present (use "git add" to track)
---------------------------

```
使用 ``git add`` 將檔案列入追蹤後,git 會顯示檔案預計在下一次提交時送出。

.. code-block:: prettyprint

```
    $ git status
    # On branch master
    #
    # Initial commit
    #
    # Changes to be committed:
    #   (use "git rm --cached <file>..." to unstage)
    #
    #       new file:   new.txt
    #
--------------------------

```

``git add`` 指令後方除了檔名之外,也可以使用目錄名稱或是萬用字元當作輸入:

- ``git add .``:將目前所在目錄下的所有檔案 (包含子目錄) 加入追蹤。
- ``git add *.c``:將所有以「.c」結尾的檔案 (不包含子目錄) 加入追蹤。
- ``git add -p``:將目前所在目錄下的所有檔案的更改之處逐一顯示出來,並讓使用者確認是否要加入追蹤。





commit
------

	**commit的觀念**:在完成一個功能或是修改一個功能後就commit,並且這次commit的程式碼是要能夠正常運行的。

	如果一次commit多個功能,對於版本追蹤會有不好的影響,使用者會無法明確的知道是從哪一部份開始出錯。

輸入``git commit``之後

會有一個編輯介面供使用者輸入commit message

或直接輸入 ``git commit -m 'New function or something modified'``

要注意的是使用**單引號**包住commit message而非雙引號


將檔案取消追蹤
------------

在程式碼的編輯或編譯過程中,會出現一些不需要追蹤的檔案,例如:執行檔(\*.exe)、object file(\*.o)、vi的暫存檔(\*.swp)、gedit的暫存檔(\*.\*~)等。

git提供一個檔案幫助管理哪些檔案不需被追蹤,為``.gitignore``。在git中通常不會有``.gitignore``,必須由使用者新增並編輯。

只要在``.gitignore``中條列不想追蹤的檔案,並將``.gitignore``commit上去即可。若想要在``.gitignore``中輸入單行解,以``#``開頭。

:first commit: 如果已經確定該repo實作的內容,可以先針對repo建立``.gitignore``檔,對於管理上比較方便。


刪除檔案並取消追蹤
----------------

``git rm <filename>``直接取消追縱後,可以看到檔案已經被刪除了。
```
	$ cat first.dat 
	first caca
	$ git rm first.dat
	rm 'first.dat'
	$ git st
	# On branch master
	# Changes to be committed:
	#   (use "git reset HEAD <file>..." to unstage)
	#
	#	deleted:    first.dat
	#
	$ ls
	$
```

如果刪錯要救援也沒有問題!!!

- ``git reset HEAD <filename>``:回復到unstaged(modified或unmodified)狀態。
- ``git checkout -- <filename>``:回復到unmodified狀態。就可以看到檔案已經回來了。此外,這個指令還可以放棄**前次commit之後所有的變更**,如果功能被寫爛了,想要重寫的話,這個指令很受用。

git厲害的地方,漸漸有感覺了吧!!


查看目前狀態
----------

``git status``

會列出目前尚未追蹤、有改變、移除或更名等檔案的狀態,同時會有提示告訴你,

該下什麼指令來作到什麼事。

像是status這類常用的指令,可以善用熱建設定。``git config --global alias.st status``,這個熱建設定指令,

往後藉由輸入``git st``來達到與``git status``相同的效果。

查看 log
--------

``git log`` 可以加上參數增加其他資訊

如

``git log --graph`` 為 branch 畫圖

``git log --all`` 列出所有 branch 等

log 中通常會包含 commit 編號、作者、日期和 log 內容等紀錄。

若暫不需詳細資訊,可以使用 ``--oneline`` 將每個 commit log 縮短至一行。

------------------------------------------------------

參考資料
=======

http://git-scm.com/doc

http://blog.longwin.com.tw/2009/05/git-learn-initial-command-2009/