github/gitignore · Unity.gitignore
Modèle .gitignore Unity expliqué
Explique pourquoi Unity.gitignore ignore Library·Temp·Obj·Build·Logs·UserSettings et les fichiers d'IDE générés automatiquement, et pourquoi les fichiers .meta doivent absolument être commités.
Unity.gitignore suppose d'être placé à la racine du projet Unity. Les règles de dossiers du modèle commencent par /, comme /[Ll]ibrary/, et sont donc ancrées à la racine du projet : si le projet Unity se trouve dans un sous-dossier du dépôt, il faut adapter les chemins.
L'éditeur Unity crée un énorme cache (Library) lors de l'importation des assets et génère automatiquement les fichiers de solution pour l'IDE de scripts. Ce modèle bloque ces fichiers régénérables et aide à ne partager que Assets, Packages et ProjectSettings.
Explication règle par règle
| Motif | Ce qui est ignoré et pourquoi |
|---|---|
/[Ll]ibrary//[Tt]emp//[Oo]bj//[Ll]ogs/.utmp/ | Cache et dossiers temporaires de l'éditeurRésultats d'importation des assets et cache de compilation. Ils atteignent parfois plusieurs Go et sont recréés par Unity à l'ouverture du projet. |
/[Bb]uild//[Bb]uilds/*.apk*.aab*.app*.unitypackage | Résultats de buildBuilds du player et paquets exportés. Les fichiers de distribution se gèrent via des releases, pas dans le dépôt. |
/[Uu]ser[Ss]ettings/*.user*.userprefs*.suo.vs/ | Réglages personnelsDisposition et préférences personnelles de l'éditeur, fichiers utilisateur de Visual Studio. |
*.csproj*.unityproj*.sln*.slnx | Fichiers d'IDE générés automatiquementFichiers de projet et de solution que Unity recrée à chaque fois pour l'éditeur de scripts. Commités, ils provoquent de fréquents conflits car les chemins diffèrent d'une personne à l'autre. |
*.pdb*.mdb*.pdb.meta*.mdb.meta | Symboles de débogageInformations de débogage Mono·.NET et leurs fichiers meta. |
/ServerData/[Aa]ssets/StreamingAssets/aa*/[Aa]ssets/AddressableAssetsData/link.xml* | Fichiers générés par Addressables·Visual ScriptingRésultats de build d'Addressables et fichiers de liaison générés automatiquement. Ils sont recréés à chaque build. |
*.blend1*.blend1.metasysinfo.txtcrashlytics-build.properties/[Mm]emoryCaptures//[Rr]ecordings/ | DiversFichiers de sauvegarde de Blender, sous-produits des rapports de crash, captures du Memory Profiler et résultats du Recorder. |
Points d'attention en pratique
- Les fichiers
.metane sont pas ignorés. Unity relie les références entre assets grâce aux GUID des.meta: s'ils manquent, les références sont rompues dans le projet des autres. - Les gros assets binaires comme les textures, modèles ou sons se gèrent généralement avec Git LFS, pas avec gitignore.
- Si vous utilisez Visual Studio ou Rider, sélectionnez aussi les modèles VisualStudio et JetBrains ; avec l'option de suppression des doublons activée, les règles qui se recoupent sont éliminées.
Modèle d'origine
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*
Source des modèles : github/gitignore/Unity.gitignore @356fd7b (2026-09-11) · CC0-1.0