github/gitignore · Unity.gitignore
Разбор шаблона .gitignore для Unity
Почему Unity.gitignore игнорирует Library, Temp, Obj, Build, Logs, UserSettings и автоматически создаваемые файлы IDE, и почему файлы .meta обязательно нужно коммитить.
Unity.gitignore предполагает, что лежит в корне проекта Unity. Правила для папок начинаются с /, например /[Ll]ibrary/, и привязаны к корню проекта, поэтому если проект Unity находится во вложенной папке репозитория, пути нужно исправить.
Редактор Unity при импорте ассетов создаёт огромный кэш (Library) и автоматически генерирует файлы решений для IDE скриптов. Этот шаблон блокирует такие воспроизводимые файлы и помогает делиться только Assets, Packages и ProjectSettings.
Разбор правил
| Шаблон | Что и почему игнорируется |
|---|---|
/[Ll]ibrary//[Tt]emp//[Oo]bj//[Ll]ogs/.utmp/ | Кэш и временные папки редактораРезультаты импорта ассетов и кэш компиляции. Иногда занимают несколько ГБ и пересоздаются, когда Unity открывает проект. |
/[Bb]uild//[Bb]uilds/*.apk*.aab*.app*.unitypackage | Результаты сборкиСборки плеера и экспортированные пакеты. Файлы для распространения ведут в релизах, а не в репозитории. |
/[Uu]ser[Ss]ettings/*.user*.userprefs*.suo.vs/ | Личные настройкиРаскладка редактора, личные настройки и пользовательские файлы Visual Studio. |
*.csproj*.unityproj*.sln*.slnx | Автоматически создаваемые файлы IDEФайлы проектов и решений, которые Unity каждый раз заново создаёт для редактора скриптов. Если их коммитить, из-за разных путей у разных людей часто возникают конфликты. |
*.pdb*.mdb*.pdb.meta*.mdb.meta | Отладочные символыОтладочная информация Mono и .NET и её мета-файлы. |
/ServerData/[Aa]ssets/StreamingAssets/aa*/[Aa]ssets/AddressableAssetsData/link.xml* | Артефакты Addressables и Visual ScriptingРезультаты сборки Addressables и автоматически создаваемые файлы ссылок. Они создаются заново при каждой сборке. |
*.blend1*.blend1.metasysinfo.txtcrashlytics-build.properties/[Mm]emoryCaptures//[Rr]ecordings/ | ПрочееРезервные копии Blender, побочные файлы отчётов о сбоях, записи Memory Profiler и результаты Recorder. |
На что обратить внимание на практике
- Файлы
.metaне игнорируйте. Unity связывает ссылки между ассетами по GUID из.meta, и если их нет, в проекте у других людей ссылки обрываются. - Большие бинарные ассеты — текстуры, модели, аудио — обычно ведут не через gitignore, а через Git LFS.
- Если вы используете Visual Studio или Rider, выберите вместе шаблоны VisualStudio и JetBrains; при включённой опции удаления повторов пересекающиеся правила будут убраны.
Исходный шаблон
Unity.gitignore
# This .gitignore file should be placed at the root of your Unity project directory## Get latest from https://github.com/github/gitignore/blob/main/Unity.gitignore## Recommended: add any editor/OS/tool-specific ignore rules from the Global/ templates as needed.# See: https://github.com/github/gitignore/tree/main/Global#.utmp//[Ll]ibrary//[Tt]emp//[Oo]bj//[Bb]uild//[Bb]uilds//[Ll]ogs//[Uu]ser[Ss]ettings/*.log# By default unity supports Blender asset imports, *.blend1 blender files do not need to be commited to version control.*.blend1*.blend1.meta# MemoryCaptures can get excessive in size.# They also could contain extremely sensitive data/[Mm]emoryCaptures/# Recordings can get excessive in size/[Rr]ecordings/# Uncomment this line if you wish to ignore the asset store tools plugin# /[Aa]ssets/AssetStoreTools*# Autogenerated Jetbrains Rider plugin/[Aa]ssets/Plugins/Editor/JetBrains*# Jetbrains Rider personal-layer settings*.DotSettings.user# Visual Studio cache directory.vs/# Gradle cache directory.gradle/# Autogenerated VS/MD/Consulo solution and project filesExportedObj/.consulo/*.csproj*.unityproj*.sln*.slnx*.suo*.tmp*.user*.userprefs*.pidb*.booproj*.svd*.pdb*.mdb*.opendb*.VC.db# Unity3D generated meta files*.pidb.meta*.pdb.meta*.mdb.meta# Unity3D generated file on crash reportssysinfo.txt# Mono auto generated filesmono_crash.*# Builds*.apk*.aab*.unitypackage*.unitypackage.meta*.app# Crashlytics generated filecrashlytics-build.properties# TestRunner generated filesInitTestScene*.unity*# Addressables default ignores, before user customizations/ServerData/[Aa]ssets/StreamingAssets/aa*/[Aa]ssets/AddressableAssetsData/link.xml*/[Aa]ssets/Addressables_Temp*# By default, Addressables content builds will generate addressables_content_state.bin# files in platform-specific subfolders, for example:# /Assets/AddressableAssetsData/OSX/addressables_content_state.bin/[Aa]ssets/AddressableAssetsData/*/*.bin*# Visual Scripting auto-generated files/[Aa]ssets/Unity.VisualScripting.Generated/VisualScripting.Flow/UnitOptions.db/[Aa]ssets/Unity.VisualScripting.Generated/VisualScripting.Flow/UnitOptions.db.meta/[Aa]ssets/Unity.VisualScripting.Generated/VisualScripting.Core/Property Providers/[Aa]ssets/Unity.VisualScripting.Generated/VisualScripting.Core/Property Providers.meta# Auto-generated scenes by play mode tests/[Aa]ssets/[Ii]nit[Tt]est[Ss]cene*.unity*# UI Toolkit auto generated files/UIElementsSchema/# Auto-generated cache in Assets folder/[Aa]ssets/[Ss]ceneDependencyCache*
Источник шаблонов: github/gitignore/Unity.gitignore @356fd7b (2026-09-11) · CC0-1.0