github/gitignore · Unity.gitignore
شرح قالب .gitignore لـ Unity
يشرح سبب تجاهل Unity.gitignore لمجلدات Library وTemp وObj وBuild وLogs وUserSettings وملفات بيئة التطوير المولَّدة تلقائيًا، ولماذا يجب إيداع ملفات .meta دائمًا.
يفترض Unity.gitignore أنه موضوع في جذر مشروع Unity. قواعد المجلدات في القالب تبدأ بـ / مثل /[Ll]ibrary/ فهي مثبّتة في جذر المشروع، لذا إن كان مشروع Unity في مجلد فرعي من المستودع فيجب تعديل المسارات لتناسبه.
ينشئ محرر Unity ذاكرة ضخمة (Library) عند استيراد الأصول (assets)، كما يولّد تلقائيًا ملفات الحلول لبيئة تطوير السكربتات. يحجب هذا القالب هذه الملفات القابلة لإعادة الإنشاء، ويساعد على ألا يُشارَك إلا Assets وPackages وProjectSettings.
شرح القواعد
| النمط | ما الذي يتجاهله ولماذا |
|---|---|
/[Ll]ibrary//[Tt]emp//[Oo]bj//[Ll]ogs/.utmp/ | ذاكرة المحرر والمجلدات المؤقتةنتائج استيراد الأصول وذاكرة الترجمة. قد يبلغ حجمها عدة غيغابايت، ويعيد Unity إنشاءها عند فتح المشروع. |
/[Bb]uild//[Bb]uilds/*.apk*.aab*.app*.unitypackage | نتائج البناءعمليات بناء المشغّل (player) والحزم المصدَّرة. تُدار ملفات النشر عبر الإصدارات لا عبر المستودع. |
/[Uu]ser[Ss]ettings/*.user*.userprefs*.suo.vs/ | الإعدادات الشخصيةتخطيط المحرر والإعدادات الشخصية وملفات مستخدم Visual Studio. |
*.csproj*.unityproj*.sln*.slnx | ملفات بيئة التطوير المولَّدة تلقائيًاملفات المشاريع والحلول التي يعيد Unity إنشاءها كل مرة لمحرر السكربتات. إيداعها يسبب تعارضات متكررة لاختلاف المسارات من شخص لآخر. |
*.pdb*.mdb*.pdb.meta*.mdb.meta | رموز التصحيحمعلومات تصحيح Mono و.NET وملفات meta الخاصة بها. |
/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 الاحتياطية، ومخلفات تقارير الانهيار، ولقطات أداة توصيف الذاكرة، ونتائج Recorder. |
ملاحظات عملية
- لا تُتجاهَل ملفات
.meta. يربط Unity المراجع بين الأصول عبر GUID في.meta، فإن غابت انقطعت المراجع في مشاريع الآخرين. - الشائع إدارة الأصول الثنائية الكبيرة مثل الخامات (textures) والنماذج والصوتيات عبر Git LFS لا عبر gitignore.
- إن كنت تستخدم 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