github/gitignore · Unity.gitignore
Penjelasan template .gitignore Unity
Menjelaskan mengapa Unity.gitignore mengabaikan Library, Temp, Obj, Build, Logs, UserSettings, dan file IDE yang dibuat otomatis, serta mengapa file .meta wajib di-commit.
Unity.gitignore mengasumsikan diletakkan di root proyek Unity. Aturan foldernya diawali / seperti /[Ll]ibrary/ sehingga terpaku pada root proyek, jadi jika proyek Unity berada di subfolder repositori, path-nya harus disesuaikan.
Editor Unity membuat cache raksasa (Library) saat mengimpor aset, dan juga otomatis membuat file solution untuk IDE skrip. Template ini memblokir file yang dapat dibuat ulang tersebut dan membantu agar hanya Assets, Packages, dan ProjectSettings yang dibagikan.
Penjelasan per aturan
| Pola | Apa yang diabaikan dan mengapa |
|---|---|
/[Ll]ibrary//[Tt]emp//[Oo]bj//[Ll]ogs/.utmp/ | Cache editor dan folder sementaraHasil impor aset dan cache kompilasi. Kadang mencapai beberapa GB dan dibuat ulang saat Unity membuka proyek. |
/[Bb]uild//[Bb]uilds/*.apk*.aab*.app*.unitypackage | Hasil buildBuild player dan paket yang diekspor. File distribusi dikelola lewat rilis, bukan repositori. |
/[Uu]ser[Ss]ettings/*.user*.userprefs*.suo.vs/ | Pengaturan pribadiTata letak editor, pengaturan pribadi, dan file pengguna Visual Studio. |
*.csproj*.unityproj*.sln*.slnx | File IDE yang dibuat otomatisFile project dan solution yang dibuat ulang Unity setiap kali untuk editor skrip. Jika di-commit, path yang berbeda untuk setiap orang sering menimbulkan konflik. |
*.pdb*.mdb*.pdb.meta*.mdb.meta | Simbol debugInformasi debug Mono dan .NET beserta file meta-nya. |
/ServerData/[Aa]ssets/StreamingAssets/aa*/[Aa]ssets/AddressableAssetsData/link.xml* | Hasil generate Addressables dan Visual ScriptingHasil build Addressables dan file link yang dibuat otomatis. Dibuat baru setiap build. |
*.blend1*.blend1.metasysinfo.txtcrashlytics-build.properties/[Mm]emoryCaptures//[Rr]ecordings/ | LainnyaFile cadangan Blender, produk sampingan laporan crash, tangkapan Memory Profiler, dan hasil Recorder. |
Hal yang perlu diperhatikan dalam praktik
- Jangan abaikan file
.meta. Unity menghubungkan referensi antar-aset dengan GUID di.meta, sehingga jika hilang, referensi di proyek orang lain akan terputus. - Aset biner besar seperti tekstur, model, dan audio umumnya dikelola dengan Git LFS, bukan gitignore.
- Jika memakai Visual Studio atau Rider, pilih juga template VisualStudio dan JetBrains; dengan opsi hapus duplikat aktif, aturan yang tumpang tindih akan dirapikan.
Template asli
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*
Sumber template: github/gitignore/Unity.gitignore @356fd7b (2026-09-11) · CC0-1.0