Есть ли какие-либо общие закономерности о том, что в git-репозитории всегда нужно добавлять в .gitignore
и что точно не стоит?
Навеяно этим вопросом: Что должно быть в gitignore для Visual Studio?
Stack Overflow на русском — это сайт вопросов и ответов для программистов. Присоединяйтесь! Регистрация займёт не больше минуты.
Присоединиться к сообществуЕсть ли какие-либо общие закономерности о том, что в git-репозитории всегда нужно добавлять в .gitignore
и что точно не стоит?
Навеяно этим вопросом: Что должно быть в gitignore для Visual Studio?
target/
, output/
, release/
, debug/
. Эти файлы можно получить из исходного кода, поэтому их версионирование не имеет смысла.*.log
), результаты работы и т.п. *~
.thumbs.db
, .DS_Store
.git
(ее в любом случае нельзя добавить в индекс) и другие файлы: .gitattributes
, .gitignore
.Обязательно системные файлы ОС и бекапы
### Linux template
*~
# KDE directory preferences
.directory
# MacOS
.DS_Store
.AppleDouble
.LSOverride
Файлы самих IDE (если вы работаете на локалке)
### NetBeans template
nbproject/private/
build/
nbbuild/
dist/
nbdist/
nbactions.xml
nb-configuration.xml
.nb-gradle/
### JetBrains template
# Covers JetBrains IDEs: IntelliJ, RubyMine, PhpStorm, AppCode, PyCharm, CLion, Android Studio
*.iml
## Directory-based project format:
.idea/
Разные плагины
## Plugin-specific files:
# IntelliJ
/out/
# mpeltonen/sbt-idea plugin
.idea_modules/
# JIRA plugin
atlassian-ide-plugin.xml
# Crashlytics plugin (for Android Studio and IntelliJ)
com_crashlytics_export_strings.xml
crashlytics.properties
crashlytics-build.properties
Файловая система
# Thumbnails
._*
# Files that might appear in the root of a volume
.DocumentRevisions-V100
.fseventsd
.Spotlight-V100
.TemporaryItems
.Trashes
.VolumeIcon.icns
# Directories potentially created on remote AFP share
.AppleDB
.AppleDesktop
Network Trash Folder
Temporary Items
.apdisk
Дополнение
Из комментария @Timofey Bondarev
Оказывается есть удобный сайт для генерации .gitignore
– https://www.gitignore.io
# Created by .ignore support plugin (hsz.mobi)
А я вот сейчас влезу и выскажу непопулярное мнение.
Не смейте копипастить "стандартные" .gitignore. Вы должны понимать каждую строчку, иначе вы потонете в потоке WTF.
Всё это должно лежать в глобальном .gitignore, а не копипаститься в каждый репозиторий. Если ваша операционная система гадит в файловой системе, то разбирайтесь с этим на уровне системы, а не каждого репозитория, с которым работаете.
Файлы IDE и всего к нему подключаемого. Вам нужно понимать, какие файлы и для чего нужны. Ради примера:
R# + C#: MySolution.sln.DotSettings
— "командные" настройки для проекта, MySolution.sln.DotSettings.user
— "личные" настройки для проекта (есть ещё "системные", они в другом месте лежат). Нужно не только следить, чтобы заигнорен был правильный файл, но и чтобы изменённые настройки попадали в нужный файл, иначе с командой будут разногласия.
IDEA: есть некислые мануалы по тому, какие файлы нужно хранить и зачем. Нельзя просто взять и заигнорить .idea/
, потому что отвалятся настройки проекта. Нельзя просто взять и оставить .idea/
, потому что ваши личные пути попадут ко всем и наплодят конфликтов. В других средах файлов может быть от нуля до бесконечности, готовьтесь изучить свой инструмент.
Генерируемые при сборке файлы. В разных языках и средах разные традиции, а вокруг отдельных файлов разгораются нешуточные споры. Ради примера:
Composer + PHP: Хранить или не хранить composer.lock
— зависит от приоритетов команды, библиотеку или приложение вы разрабатываете, и от личных вкусов. Вам нужно хорошо понимать, какие плюсы и минусы у нахождения файла в репозитории.
T4 + C#: В C# принято хранить вывод кодогенерации, чтобы можно было легко собрать проект. При этом можно настроить сборку, чтобы кодогенерация запускалась при сборке, однако это возможно не для всех скриптов. Надо отметить, что кодогенерация не из T4 обычно попадает в Output, поэтому игнорируется. В других языках и средах чаще исповедуют идеологию, что вывод кодогенерации никогда не коммитится.
Бинарники. Git отвратительно работает с бинарниками, в отличие от "отсталых" VCS типа SVN. Репозиторий непомерно разрастается, если файлы часто обновлять.
Если вы обновляете файлы редко, и они мелкие, то можно положить файлы на место.
В противном случае лучше спрятать файлы в какое-нибудь другое место. Есть как универсальные костыли для Git (Git LFS), так и специфические для языка и среды инструменты (личный сервер NuGet).
Если вы можете использовать NuGet, Composer, CPAN, Lein, Maven, то используйте. Бинарные зависимости должны быть там.
Вы должны стремиться к тому, чтобы в репозитории было минимальное возможное количество файлов, которых достаточно для сборки всего проекта абсолютно без вмешательства и настройки чего бы то ни было.
Часто идеал недостижим. Так что ищите компромисс.
[core] excludesfile
в .gitconfig
. На уровне пользователя.