ما ملف ‎.gitignore؟

يُخبر ملف ‎.gitignore Git بالملفات التي يجب استثناؤها من التحكم بالإصدارات: التبعيات التي يمكنك تثبيتها مجددًا (مثل node_modules)، ومخرجات البناء، والسجلات، وذاكرات التخزين المؤقت، وإعدادات المحرر، والملفات التي يتركها نظام التشغيل، مثل ‎.DS_Store على macOS أو Thumbs.db على Windows. ضعه في المجلد الجذر لمستودعك. تنطبق أنماطه على ذلك المجلد وكل المجلدات الموجودة تحته.

مصدر القوالب

القوالب مأخوذة من مجموعة GitHub الرسمية، مستودع github/gitignore، وهي القوالب نفسها التي يوفّرها GitHub عند إنشاء مستودع. تحمّل الأداة نسخة تُحدَّث يوميًا. وتأتي في ثلاث مجموعات:

  • القوالب الرئيسية للغات وأُطر العمل والأدوات، مثل Node وPython وJava وGo وRust وUnity وWordPress.
  • القوالب العامة للمحررات وأنظمة التشغيل والأدوات الأخرى، مثل macOS وWindows وLinux وVisualStudioCode وJetBrains وVim. وهي مناسبة لملف ‎.gitignore الخاص بالمشروع، وكذلك للملف العام الذي يمكن لـ Git تطبيقه على جميع مستودعاتك.
  • قوالب المجتمع لأُطر العمل والأدوات الأكثر تخصصًا، التي يديرها المجتمع، مثل JavaScript/Vue أو Python/JupyterNotebooks.

كيفية الاستخدام

  1. ابدأ باختيار سريع لنوع مشروع شائع. سيختار قوالب حزمة التقنيات، بالإضافة إلى macOS وWindows والمحرر المستخدم معها عادةً.
  2. أو ابحث في حقل القوالب واختر كل لغة وإطار عمل ومحرر ونظام تشغيل يستخدمه مشروعك. أزل تحديد أي قالب، أو اضغط على Backspace في الحقل، لإزالته.
  3. يُنشأ ملف ‎.gitignore أثناء الاختيار، مع وضع كل قالب تحت تعليق عنوان خاص به، وبالترتيب الذي اخترته.
  4. انسخه، أو نزّله واحفظه في المجلد الجذر لمستودعك باسم ‎.gitignore. لا تحفظ المتصفحات الملفات التي تبدأ أسماؤها بنقطة، لذا سيُنزَّل الملف باسم gitignore.txt أو gitignore؛ أعد تسميته إلى ‎.gitignore.

نصائح

  • قد يشترك قالبان في نمط واحد، مثل node_modules/ في Node وNextjs. لا يسبب تكرار النمط أي مشكلة.
  • لا يمنع النمط تتبّع Git لملف يتتبّعه بالفعل. لإيقاف تتبّعه مع إبقائه على القرص، نفّذ git rm --cached متبوعًا بمسار الملف، ثم أنشئ commit.
  • يعيد السطر الذي يبدأ بـ ! الملفات التي استبعدها نمط سابق. يستخدم قالب VisualStudioCode هذا الأسلوب للإبقاء على الإعدادات المشتركة، مثل ‎.vscode/settings.json، في المستودع.

الميزات

  • قوالب ‎.gitignore الرسمية من GitHub، المحدَّثة يوميًا
  • اللغات وأُطر العمل والمحررات وأنظمة التشغيل في قائمة واحدة قابلة للبحث
  • اختيارات سريعة لأنواع المشاريع الشائعة
  • كل قالب تحت عنوان خاص به
  • نسخ الملف أو تنزيله