github/gitignore · Unity.gitignore
Unity-.gitignore-Vorlage erklärt
Erklärt, warum Unity.gitignore Library·Temp·Obj·Build·Logs·UserSettings und automatisch erzeugte IDE-Dateien ignoriert und warum .meta-Dateien unbedingt committet werden müssen.
Unity.gitignore setzt voraus, dass sie im Stammverzeichnis des Unity-Projekts liegt. Die Ordnerregeln der Vorlage beginnen mit /, etwa /[Ll]ibrary/, und sind damit am Projektstamm verankert. Liegt das Unity-Projekt in einem Unterordner des Repositorys, müssen die Pfade angepasst werden.
Der Unity-Editor erzeugt beim Import von Assets einen riesigen Cache (Library) und legt automatisch Lösungsdateien für die Skript-IDE an. Diese Vorlage blockiert solche neu erzeugbaren Dateien und hilft, nur Assets, Packages und ProjectSettings zu teilen.
Regeln im Einzelnen
| Muster | Was ignoriert wird und warum |
|---|---|
/[Ll]ibrary//[Tt]emp//[Oo]bj//[Ll]ogs/.utmp/ | Editor-Cache und temporäre OrdnerErgebnisse des Asset-Imports und Kompilier-Cache. Sie können mehrere GB groß werden und werden von Unity beim Öffnen des Projekts neu erzeugt. |
/[Bb]uild//[Bb]uilds/*.apk*.aab*.app*.unitypackage | Build-ErgebnissePlayer-Builds und exportierte Pakete. Distributionsdateien werden über Releases verwaltet, nicht im Repository. |
/[Uu]ser[Ss]ettings/*.user*.userprefs*.suo.vs/ | Persönliche EinstellungenEditor-Layout und persönliche Einstellungen sowie Visual-Studio-Benutzerdateien. |
*.csproj*.unityproj*.sln*.slnx | Automatisch erzeugte IDE-DateienProjekt- und Lösungsdateien, die Unity für den Skripteditor jedes Mal neu erzeugt. Werden sie committet, entstehen häufig Konflikte, da sich die Pfade je Person unterscheiden. |
*.pdb*.mdb*.pdb.meta*.mdb.meta | DebugsymboleDebuginformationen von Mono·.NET und deren Meta-Dateien. |
/ServerData/[Aa]ssets/StreamingAssets/aa*/[Aa]ssets/AddressableAssetsData/link.xml* | Erzeugnisse von Addressables·Visual ScriptingBuild-Ergebnisse von Addressables und automatisch erzeugte Link-Dateien. Sie entstehen bei jedem Build neu. |
*.blend1*.blend1.metasysinfo.txtcrashlytics-build.properties/[Mm]emoryCaptures//[Rr]ecordings/ | SonstigesSicherungsdateien von Blender, Nebenprodukte von Absturzberichten, Aufzeichnungen des Memory Profilers und Ergebnisse des Recorders. |
Hinweise für die Praxis
.meta-Dateien werden nicht ignoriert. Unity verknüpft Verweise zwischen Assets über die GUIDs in.meta; fehlen sie, brechen die Verweise im Projekt der anderen.- Große binäre Assets wie Texturen, Modelle oder Audio verwaltet man üblicherweise mit Git LFS, nicht mit gitignore.
- Wenn Sie Visual Studio oder Rider nutzen, wählen Sie zusätzlich die Vorlagen VisualStudio und JetBrains; bei aktivierter Duplikatentfernung werden sich überschneidende Regeln bereinigt.
Originalvorlage
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*
Vorlagenquelle: github/gitignore/Unity.gitignore @356fd7b (2026-09-11) · CC0-1.0