github/gitignore · Unity.gitignore
Plantilla .gitignore de Unity explicada
Explica por qué Unity.gitignore ignora Library, Temp, Obj, Build, Logs, UserSettings y los archivos de IDE generados automáticamente, y por qué los archivos .meta sí deben confirmarse.
Unity.gitignore da por hecho que se coloca en la raíz del proyecto de Unity. Las reglas de carpetas de la plantilla empiezan por /, como /[Ll]ibrary/, y quedan fijadas a la raíz del proyecto, así que si el proyecto de Unity está en una subcarpeta del repositorio hay que corregir las rutas.
El editor de Unity crea una caché enorme (Library) al importar recursos y también genera automáticamente archivos de solución para el IDE de scripts. Esta plantilla bloquea esos archivos regenerables y ayuda a que solo se compartan Assets, Packages y ProjectSettings.
Explicación regla por regla
| Patrón | Qué ignora y por qué |
|---|---|
/[Ll]ibrary//[Tt]emp//[Oo]bj//[Ll]ogs/.utmp/ | Caché del editor y carpetas temporalesSon los resultados de importar recursos y la caché de compilación. A veces llegan a varios GB y Unity los vuelve a crear al abrir el proyecto. |
/[Bb]uild//[Bb]uilds/*.apk*.aab*.app*.unitypackage | Resultados de compilaciónSon las compilaciones del reproductor y los paquetes exportados. Los archivos de distribución se gestionan como versiones, no en el repositorio. |
/[Uu]ser[Ss]ettings/*.user*.userprefs*.suo.vs/ | Ajustes personalesSon la disposición del editor, los ajustes personales y los archivos de usuario de Visual Studio. |
*.csproj*.unityproj*.sln*.slnx | Archivos de IDE generados automáticamenteSon archivos de proyecto y solución que Unity vuelve a crear cada vez para el editor de scripts. Si se confirman, las rutas difieren entre personas y los conflictos son frecuentes. |
*.pdb*.mdb*.pdb.meta*.mdb.meta | Símbolos de depuraciónSon la información de depuración de Mono y .NET y sus archivos meta. |
/ServerData/[Aa]ssets/StreamingAssets/aa*/[Aa]ssets/AddressableAssetsData/link.xml* | Generados de Addressables y Visual ScriptingSon los resultados de compilación de Addressables y los archivos de enlace generados automáticamente. Se crean de nuevo en cada compilación. |
*.blend1*.blend1.metasysinfo.txtcrashlytics-build.properties/[Mm]emoryCaptures//[Rr]ecordings/ | OtrosSon archivos de copia de seguridad de Blender, subproductos de informes de fallos, capturas del Memory Profiler y resultados de Recorder. |
Precauciones en la práctica
- No ignores los archivos
.meta. Unity enlaza las referencias entre recursos mediante el GUID del.meta, así que si faltan, las referencias se rompen en el proyecto de otras personas. - Los recursos binarios grandes, como texturas, modelos y audio, suelen gestionarse con Git LFS, no con gitignore.
- Si usas Visual Studio o Rider, elige también las plantillas VisualStudio y JetBrains; con la opción de eliminar duplicados activada, las reglas que se solapan se ordenan.
Plantilla original
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*
Origen de las plantillas: github/gitignore/Unity.gitignore @356fd7b (2026-09-11) · CC0-1.0