Як ігнорувати файли в каталозі в Git?


544

Який власний синтаксис .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/*

?


5
чи .gitignoreрозрізняє файли та каталоги, які він ігнорує? наприклад, не dataпроти data/середніх різних речей?
Чарлі Паркер

6
@CharlieParker так-іш: dataігнорує файли та каталоги, які відповідають, data/ігноруватиме лише каталоги, які відповідають.
jox

Завжди пам’ятайте, якщо ви інсценізували або вчинили файл, який ви намагаєтесь проігнорувати, то не можна його ігнорувати :( Просто мої 2 копійки після того, як я подумав, що я помилився з моїм малюнком і витратив чверть години.
Адам,

@Адам правильно, вам доведеться оновити .gitignore, а потім untage / git rm - кешувати файл.
Chris McKnight

Відповіді:


374

ФОРМАТ ПАТЕРНУ

  • Порожній рядок не відповідає файлам, тому він може служити роздільником для читабельності.

  • Рядок, що починається з, #слугує коментарем.

  • Необов’язковий префікс, !який заперечує шаблон; будь-який відповідний файл, виключений за попереднім шаблоном, знову буде включений. Якщо заперечений візерунок збігається, це скасує джерела шаблонів нижчих пріоритетів.

  • Якщо візерунок закінчується косою рисою, вона видаляється з метою наступного опису, але вона знайде лише збіг з каталогом. Іншими словами, foo/буде відповідати каталогу fooта шляхів під ним, але не буде відповідати звичайному файлу або символічному посиланню foo(це відповідає способу роботи pathspec взагалі в git).

  • Якщо візерунок не містить косу /рису, git розглядає його як зразок глобальної оболонки і перевіряє відповідність імені шляху відносно місця розташування .gitignoreфайлу (відносно верхнього рівня робочого дерева, якщо не з .gitignoreфайлу).

  • В іншому випадку git трактує візерунок як глобус оболонки, придатний для споживання за fnmatch(3)допомогою FNM_PATHNAMEпрапора: подвійні символи в шаблоні не збігаються з а /в імені шляху. Наприклад, Documentation/*.htmlсірники, Documentation/git.htmlале немає Documentation/ppc/ppc.htmlабо tools/perf/Documentation/perf.html.

  • Початкова косою рисою відповідає початок назви шляху. Наприклад, /*.cсірники, cat-file.cале ні mozilla-sha1/sha1.c.

Більше ви можете знайти тут

git help gitignore
або
man gitignore


2
Як я можу поставити .gitignore файл на верхній рівень і змусити його працювати для будь-якої папки під ним? Дякую тобі.
Рой

104
-1 TL; DR і ледь відповідає на питання. Йдеться про каталоги, а не про файли, тож розкріплений розділ - це лише приблизно певна розумова гімнастика. @Jefromi був більш прямим.
Боб Штейн

Я прочитав людину, і відповідь @ Джефромі краща - якщо ви також читаєте попередження @ jox - і @ Лука Лутта може бути кориснішим для ігнорування, наприклад, файлів проектів IDE.
WillC

1
Це фактично копія-паста з документації на git
mcont

1
Не впевнений (по суті) копіювання вставлення manсторінки або офіційного документа є найкращим форматом для SO ...
jdk1.0

183

Це було б колишнє. Перейдіть також за допомогою розширень замість структури папок.

Тобто мій приклад файлу ігнорування розробки C #:

#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
~$*

Оновлення

Я думав, що надам оновлення з коментарів нижче. Хоча не відповідає безпосередньо на запитання ОП, див. Нижче для отримання додаткових прикладів .gitignoreсинтаксису.

Вікі спільноти (постійно оновлюється):

.gitignore для проектів та рішень Visual Studio

Більше прикладів із конкретним використанням мови можна знайти тут (завдяки коментарю Chris McKnight):

https://github.com/github/gitignore


5
@Stallman, ось це range. Так воно відповідає, *.Objяк і *.obj.
Норберт

131

Шляхи, які містять косу рису, приймаються відносно до каталогу, що містить файл .gitignore - як правило, верхній рівень вашого сховища, хоча ви також можете розмістити їх у підкаталогах.

Отже, оскільки у всіх наведених прикладах контури містять косу рису, дві версії однакові. Єдиний раз, коли вам потрібно поставити провідну косу рису, - це коли її вже немає на шляху. Наприклад, щоб ігнорувати foo лише на верхньому рівні сховища, використовуйте /foo. Просто написання fooбуде ігнорувати все, що називається foo, в будь-якому місці сховища.

Ваші шаблонні символи також зайві. Якщо ви хочете ігнорувати весь каталог, просто назвіть його:

lib/model/om

Єдиний привід використовувати подвійні символи так, як у вас є, якщо згодом ви хочете щось ігнорувати в каталозі:

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

5
Краще пояснення, ніж прийнята відповідь на це питання
eerrzz

78

Провідна риса вказує на те, що запис ігнорування має бути дійсним лише щодо каталогу, в якому знаходиться файл .gitignore. Завдання *.oбуде ігнорувати всі файли .o в цьому каталозі і підкаталогах, а /*.oпросто ігноруватиме їх в цьому директорії, в той час як раз, /foo/*.oбуде тільки ігнорувати їх в /foo/*.o.


34

Якщо ви хочете поставити .gitignore файл на верхньому рівні і змусити його працювати для будь-якої папки нижче його використання /**/ .

Наприклад, щоб ігнорувати всі *.mapфайли в /src/main/папці та підпапках:

/src/main/**/*.map

Мені потрібно було це зробити. Не впевнений, для чого вам потрібні два ** . Одного мені вистачило.
Новокаїн

8
** також відповідає файлам у підкаталогах
petrsyn

Дякую за інформацію @petrsyn
Novocaine

30

Обидва приклади в питанні насправді є дуже поганими прикладами, які можуть призвести до втрати даних!

Моя порада: ніколи не додайте /*до каталогів файли .gitignore, якщо у вас немає вагомих причин!

Вагомою причиною може бути, наприклад, те, що написав Джефромі: "якщо ви згодом хочете щось ігнорувати в каталозі" .

Причина, чому цього інакше не слід робити, полягає в тому, що додавання /*до каталогів працює, з одного боку, таким чином, щоб воно правильно ігнорувало весь вміст каталогу, але з іншого - це має небезпечний побічний ефект:

Якщо ви виконаєте git stash -u(тимчасово git clean -dfзберігати відстежені та відслідковувані файли) або (видалити відслідковувані, але ігнорувати файли) у вашому сховищі, всі каталоги, які ігноруються доданими, /*будуть безповоротно видалені !

Якесь тло

Мені довелося навчитися цьому важким шляхом. Хтось із моєї команди /*приєднувався до деяких каталогів у нашому .gitignore. З часом у мене були випадки, коли певні каталоги раптом зникали. Довідники з гігабайти локальних даних, необхідні нашій програмі. Ніхто не міг це пояснити, і я завжди хочу повторно завантажити всі дані. Через деякий час у мене з’явилося поняття, що це, можливо, стосується git stash. Одного разу я хотів очистити місцеве репо (зберігаючи ігноровані файли), і я використовував, git clean -dfі знову мої дані не було. Цього разу мені було достатньо і досліджено проблему. Я нарешті зрозумів, що причина - додається /*.

Я припускаю, що це можна якось пояснити тим, що directory/* він ігнорує весь вміст каталогу, але не сам каталог. Таким чином, він ні вважається відстеженим, ні ігнорується, коли речі видаляються. Хоча git statusі git status --ignoredдайте трохи іншу картину на ньому.

Як відтворювати

Ось як відтворити поведінку. Зараз я використовую Git 2.8.4.

Каталог, званий localdata/із манекеновим файлом у ньому ( important.dat), буде створений у локальному сховищі git, а вміст буде проігноровано, помістивши /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тут зробите , ви отримаєте:

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 і побачу, що вони думають про це.


15

Це було б:

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підкаталог , який повинен бути проігнорований (див це як приклад того , що ви можете зробити з asterics).


14

Перший. Ці шляхи до файлу є відносними звідки ваш файл .gitignore.


2
Це справедливо лише для шаблонів, які містять косу рису. Ім’я одного каталогу, як "mydir", також ігнорує каталоги (та файли), які знаходяться в папках на будь-якій глибині. Якщо поставити косу рису спереду, вона зробить її відносною, де знаходиться ваш файл .gitignore.
jox

4

Я підтримую сервіс на основі GUI та CLI, який дозволяє генерувати .gitignoreшаблони дуже легко на https://www.gitignore.io .

Ви можете або ввести потрібні шаблони в полі пошуку, або встановити псевдонім командного рядка та запустити

$ gi swift,osx


0

Зразок .gitignore- файлу може виглядати як нижче для проекту Android Studio

# 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
Використовуючи наш веб-сайт, ви визнаєте, що прочитали та зрозуміли наші Політику щодо файлів cookie та Політику конфіденційності.
Licensed under cc by-sa 3.0 with attribution required.