如何忽略Git中目錄中的文件？

Question

.gitignore文件忽略目錄中文件的正確語法是什么？

可不可能是

config/databases.yml
cache/*
log/*
data/sql/*
lib/filter/base/*
lib/form/base/*
lib/model/map/*
lib/model/om/*

要么

/config/databases.yml
/cache/*
/log/*
/data/sql/*
/lib/filter/base/*
/lib/form/base/*
/lib/model/map/*
/lib/model/om/*

？

Answer 1

模式格式

• 空行不匹配任何文件，因此它可以作為可讀性的分隔符。

• 以#開頭的行作為注釋。

• 一個可選的前綴! 否定了這種模式; 之前模式排除的任何匹配文件將再次包含在內。 如果否定模式匹配，則將覆蓋較低優先級模式源。

• 如果模式以斜杠結尾，則為了以下描述的目的將其刪除，但它只會找到與目錄的匹配項。 換句話說， foo/將匹配目錄foo和它下面的路徑，但是不匹配常規文件或符號鏈接foo （這與pathpec在git中的工作方式一致）。

• 如果模式不包含斜杠/ ，git將其視為shell glob模式，並檢查相對於.gitignore文件位置的路徑名的匹配（相對於工作樹的頂層，如果不是來自.gitignore文件）。

• 否則，git將模式視為適合fnmatch(3)使用FNM_PATHNAME標志的shell glob：模式中的通配符與路徑名中的/不匹配。 例如， Documentation/*.html與Documentation/git.html匹配，但不匹配Documentation/git.html Documentation/ppc/ppc.html或tools/perf/Documentation/perf.html 。

• 前導斜杠與路徑名的開頭匹配。 例如，/ * /*.c匹配cat-file.c /*.c但不匹配mozilla-sha1/sha1.c

你可以在這里找到更多

git help gitignore
要么
man gitignore

Answer 2

這將是前者。 也可以通過擴展而不是文件夾結構。

即我的示例C＃development忽略文件：

#OS junk files
[Tt]humbs.db
*.DS_Store

#Visual Studio files
*.[Oo]bj
*.user
*.aps
*.pch
*.vspscc
*.vssscc
*_i.c
*_p.c
*.ncb
*.suo
*.tlb
*.tlh
*.bak
*.[Cc]ache
*.ilk
*.log
*.lib
*.sbr
*.sdf
ipch/
obj/
[Bb]in
[Dd]ebug*/
[Rr]elease*/
Ankh.NoLoad

#Tooling
_ReSharper*/
*.resharper
[Tt]est[Rr]esult*

#Project files
[Bb]uild/

#Subversion files
.svn

# Office Temp Files
~$*

更新

我想我會從下面的評論中提供更新。 雖然沒有直接回答OP的問題，但有關.gitignore語法的更多示例，請參閱以下內容。

社區維基（不斷更新）：

.gitignore for Visual Studio項目和解決方案

可以在這里找到更多具有特定語言用法的例子（感謝Chris McKnight的評論）：

https://github.com/github/gitignore

Answer 3

包含斜杠的路徑被認為是相對於包含.gitignore文件的目錄 - 通常是存儲庫的頂層，但您也可以將它們放在子目錄中。

所以，因為在你提供的所有例子中，路徑都包含斜杠，兩個版本是相同的。 只有在路徑中沒有一個時，才需要設置一個前導斜杠。 例如，要僅在存儲庫的頂級忽略foo，請使用/foo 。 簡單地寫foo會忽略存儲庫中任何名為foo的東西。

你的通配符也是多余的。 如果要忽略整個目錄，只需將其命名為：

lib/model/om

使用通配符的唯一原因是，如果您打算隨后忽略目錄中的某些內容：

lib/model/om/*      # ignore everything in the directory
!lib/model/om/foo   # except foo

Answer 4

前導斜杠表示忽略條目僅對.gitignore文件所在的目錄有效。 指定*.o將忽略此目錄和所有子目錄中的所有.o文件，而/*.o *.o將在該目錄中忽略它們，而/foo/*.o只會忽略它們在/foo/*.o中。

Answer 5

如果要將.gitignore文件放在頂層並使其適用於下面的任何文件夾，請使用/**/ 。

例如，要忽略/src/main/文件夾和子文件夾中的所有*.map文件，請使用：

/src/main/**/*.map

Answer 6

問題中的兩個例子實際上是非常糟糕的例子，可能導致數據丟失！

我的建議：永遠不要將/*附加到.gitignore文件中的目錄，除非你有充分的理由！

一個很好的理由是例如Jefromi寫的： “如果你打算隨后忽略目錄中的某些東西” 。

不應該這樣做的原因是，對目錄的附加/*一方面以正確忽略目錄的所有內容的方式工作，但另一方面它具有危險的副作用：

如果在git stash -u執行git stash -u （暫時存儲已跟蹤和未跟蹤的文件）或git clean -df （刪除未跟蹤但保留被忽略的文件），則所有被忽略並附加/*將被不可逆轉地刪除 ！

一些背景

我必須以艱難的方式學習這一點。 我團隊中的某個人正在將/*附加到我們的.gitignore中的某些目錄中。 隨着時間的推移，某些目錄會突然消失。 我們的應用程序需要具有千兆字節本地數據的目錄。 沒有人可以解釋它，我總是重新下載所有數據。 過了一會兒，我得到了一個可能與git stash的想法。 有一天，我想清理我的本地git clean -df （同時保持被忽略的文件），我正在使用git clean -df ，我的數據又消失了。 這次我受夠了並調查了這個問題。 我終於想通了原因是附加了/* 。

我假設它可以通過某種方式解釋，即directory/*確實忽略了目錄的所有內容而不是目錄本身。 因此，當事情被刪除時，它既不被視為被跟蹤也不被忽略。 即使git status和git status --ignored也會給出一個略有不同的圖片。

如何重現

以下是如何重現行為。 我目前正在使用Git 2.8.4。

將在本地git存儲庫中創建名為localdata/且其中包含虛擬文件的目錄（ important.dat ），並將/localdata/*放入.gitignore文件中以忽略內容。 當現在執行兩個提到的git命令之一時，該目錄將（意外地）丟失。

mkdir test
cd test
git init
echo "/localdata/*" >.gitignore
git add .gitignore
git commit -m "Add .gitignore."
mkdir localdata
echo "Important data" >localdata/important.dat
touch untracked-file

如果你做一個git status --ignored在這里git status --ignored ，你會得到：

On branch master
Untracked files:
  (use "git add <file>..." to include in what will be committed)

  untracked-file

Ignored files:
  (use "git add -f <file>..." to include in what will be committed)

  localdata/

現在要么做

git stash -u
git stash pop

要么

git clean -df

在這兩種情況下，據稱被忽略的目錄localdata都將消失！

不確定這是否可以被視為一個錯誤，但我想這至少是一個沒人需要的功能。

我將把它報告給git開發列表，看看他們對它的看法。

Answer 7

第一個。 這些文件路徑與.gitignore文件的位置相對。

Answer 8

這將是：

config/databases.yml
cache
log
data/sql
lib/filter/base
lib/form/base
lib/model/map
lib/model/om

甚至可能：

config/databases.yml
cache
log
data/sql
lib/*/base
lib/model/map
lib/model/om

如果filter和form是lib中唯一具有需要忽略的base子目錄的目錄（請參閱它作為您可以使用星號進行操作的示例）。

Answer 9

我正在維護基於GUI和CLI的服務，允許您在https://www.gitignore.io上輕松生成.gitignore模板。

您可以在搜索字段中鍵入所需的模板，也可以安裝命令行別名並運行

$ gi swift,osx

Answer 10

對於Android Studio項目，示例.gitignore文件可能如下所示

# built application files
*.apk
*.ap_

# files for the dex VM
*.dex

# Java class files
*.class

# generated files
bin/
gen/

# Local configuration file (sdk path, etc)
local.properties


#Eclipse
*.pydevproject
.project
.metadata
bin/**
tmp/**
tmp/**/*
*.tmp
*.bak
*.swp
*~.nib
local.properties
.classpath
.settings/
.loadpath
YourProjetcName/.gradle/
YourProjetcName/app/build/
*/YourProjetcName/.gradle/
*/YourProjetcName/app/build/

# External tool builders
.externalToolBuilders/

# Locally stored "Eclipse launch configurations"
*.launch

# CDT-specific
.cproject

# PDT-specific
.buildpath

# Proguard folder generated by Eclipse
proguard/

# Intellij project files
*.iml
*.ipr
*.iws
.idea/
/build
build/
*/build/
*/*/build/
*/*/*/build/
*.bin
*.lock
YourProjetcName/app/build/
.gradle
/local.properties
/.idea/workspace.xml
/.idea/libraries
.DS_Store
.gradle/
app/build/
*app/build/

# Local configuration file (sdk path, etc)
local.properties
/YourProjetcName/build/intermediates/lint-cache/api-versions-6-23.1.bin
appcompat_v7_23_1_1.xml
projectFilesBackup
build.gradle
YourProjetcName.iml
YourProjetcName.iml
gradlew
gradlew.bat
local.properties
settings.gradle
.gradle
.idea
android
build
gradle