git上傳過濾檔案

對於經常使用Git的朋友來說，.gitignore配置一定不會陌生。廢話不說多了，接下來就來說說這個.gitignore的使用。

首先要強調一點，這個檔案的完整檔名就是”.gitignore”，注意最前面有個“.”。
一般來說每個Git專案中都需要一個“.gitignore”檔案，這個檔案的作用就是告訴Git哪些檔案不需要新增到版本管理中。實際專案中，很多檔案都是不需要版本管理的，比如Python的.pyc檔案和一些包含密碼的配置檔案等等。這個檔案的內容是一些規則，Git會根據這些規則來判斷是否將檔案新增到版本控制中。

下面我們看看常用的規則：
1）/mtk/               過濾整個資料夾
2）*.zip                過濾所有.zip檔案
3）/mtk/do.c         過濾某個具體檔案

很簡單吧，被過濾掉的檔案就不會出現在git倉庫中（gitlab或github）了，當然本地庫中還有，只是push的時候不會上傳。
需要注意的是，gitignore還可以指定要將哪些檔案新增到版本管理中：
1）!*.zip
2）!/mtk/one.txt

唯一的區別就是規則開頭多了一個感嘆號，Git會將滿足這類規則的檔案新增到版本管理中。
為什麼要有兩種規則呢？想象一個場景：假如我們只需要管理/mtk/目錄中的one.txt檔案，這個目錄中的其他檔案都不需要管理，那麼我們就需要使用：
1）/mtk/
2）!/mtk/one.txt
假設我們只有過濾規則，而沒有新增規則，那麼我們就需要把/mtk/目錄下除了one.txt以外的所有檔案都寫出來！

最後需要強調的一點是，如果你不慎在建立.gitignore檔案之前就push了專案，那麼即使你在.gitignore檔案中寫入新的過濾規則，這些規則也不會起作用，Git仍然會對所有檔案進行版本管理。
簡單來說，出現這種問題的原因就是Git已經開始管理這些檔案了，所以你無法再通過過濾規則過濾它們。因此一定要養成在專案開始就建立.gitignore檔案的習慣，否則一旦push，處理起來會非常麻煩。

.gitignore配置檔案用於配置不需要加入版本管理的檔案，配置好該檔案可以為版本管理帶來很大的便利，以下是對於配置.gitignore的一些心得記錄：
1）配置語法：
以斜槓“/”開頭表示目錄；
以星號“*”通配多個字元；
以問號“?”通配單個字元
以方括號“[]”包含單個字元的匹配列表；
以歎號“!”表示不忽略(跟蹤)匹配到的檔案或目錄；

此外，git 對於 .ignore 配置檔案是按行從上到下進行規則匹配的，意味著如果前面的規則匹配的範圍更大，則後面的規則將不會生效；

2）示例說明
a）規則：fd1/*
說明：忽略目錄 fd1 下的全部內容；注意，不管是根目錄下的 /fd1/ 目錄，還是某個子目錄 /child/fd1/ 目錄，都會被忽略；
b）規則：/fd1/*
說明：忽略根目錄下的 /fd1/ 目錄的全部內容；
c）規則：
/*
!.gitignore
!/fw/bin/
!/fw/sf/
說明：忽略全部內容，但是不忽略 .gitignore 檔案、根目錄下的 /fw/bin/ 和 /fw/sf/ 目錄；

——————————————————————————————————————-
下面是線上使用過的一個gerrit裡專案程式碼的.gitignore的配置（在專案中新增.gitignore過濾檔案，在git push到gerrit裡即可）

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56

[wangshibo@gerrit-server hqsb_android]$ cat .gitignore #Built application files *.apk *.ap_   # Files for the Dalvik VM *.dex   # Java class files *.class   # Generated files */bin/ */gen/ */out/   # Gradle files .gradle/ build/ */build/ gradlew gradlew.bat   # Local configuration file (sdk path, etc) local.properties   # Proguard folder generated by Eclipse proguard/   # Log Files *.log   # Android Studio Navigation editor temp files .navigation/   # Android Studio captures folder captures/   # Intellij *.iml */*.iml   # Keystore files #*.jks #gradle wrapper gradle/   #some local files */.settings/ */.DS_Store .DS_Store */.idea/ .idea/ gradlew gradlew.bat unused.txt

再看一例

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27

[wangshibo@gerrit-server hqsb_ios$ cat .gitignore # Lines that start with '#' are comments. # IntelliJ IDEA Project files .idea *.iml *.ipr *.iws out   # Eclipse Project files .classpath .project .settings/   bin/ gen/ local.properties   .DS_Store Thumbs.db   *.bak *.tem *.temp #.swp *.*~ ~*.*

—————————————————————————————————
其實，需要清除的一點是：
有三種方法可以實現過濾掉Git裡不想上傳的檔案，這三種方法都能達到目的，只不過適用情景不一樣。

1）第一種方法
針對單一工程排除檔案，這種方式會讓這個工程的所有修改者在克隆程式碼的同時，也能克隆到過濾規則，而不用自己再寫一份，這就能保證所有修改者應用的都是同一份規則，而不是張三自己有一套過濾規則，李四又使用另一套過濾規則，個人比較喜歡這個。配置步驟如下：

在工程根目錄下建立.gitignore檔案，將要排除的檔案或目錄 寫到.gitignore這個檔案中，其中有兩種寫入方法。
a)使用命令列增加排除檔案 
排除以.class結尾的檔案 echo “*.class” >.gitignore (>> 是在檔案尾增加,> 是刪除已經存在的內容再增加)，之後會在當前目錄下生成一個.gitignore的檔案。
排除bin目錄下的檔案 echo “bin/” >.gitignore
b)最方便的辦法是，用記事本開啟，增加需要排除的檔案或目錄，一行增加一個，例如：

1 2 3 4 5 6

*.class *.apk bin/ gen/ .settings/ proguard/

2）第二種方法
全域性設定排除檔案，這會在全域性起作用，只要是Git管理的工程，在提交時都會自動排除不在控制範圍內的檔案或目錄。這種方法對開發者來說，比較省事，只要一次全域性配置，不用每次建立工程都要配置一遍過濾規則。但是這不保證其他的開發者在克隆你的程式碼後，他們那邊的規則跟你的是一樣的，這就帶來了程式碼提交過程中的各種衝突問題。
配置步驟如下：
a）像方法（1）一樣，也需要建立一個.gitignore檔案，把要排除的檔案寫進去。
b）但在這裡，我們不規定一定要把.gitnore檔案放到某個工程下面，而是任何地方，比如我們這裡放到了Git預設的Home路徑下，比如：/home/wangshibo/hqsb_ios
c）使用命令方式可以配置全域性排除檔案 git config –global core.excludesfile ~/.gitignore，你會發現在~/.gitconfig檔案中會出現excludesfile = /home/wangshibo/hqsb_ios/.gitignore。
說明Git把檔案過濾規則應用到了Global的規則中。

3）第三種方法
單個工程設定排除檔案，在工程目錄下找到.git/info/exclude，把要排除的檔案寫進去：

1 2 3 4 5 6

*.class *.apk bin/ gen/ .settings/ proguard/

這種方法就不提倡了，只能針對單一工程配置，而且還不能將過濾規則同步到其他開發者，跟方法（1）（2）比較起來沒有一點優勢。

————————Git忽略規則及.gitignore規則不生效的解決辦法—————————–

在git中如果想忽略掉某個檔案，不讓這個檔案提交到版本庫中，可以使用修改根目錄中 .gitignore 檔案的方法（如無，則需自己手工建立此檔案）。這個檔案每一行儲存了一個匹配的規則例如：