مولّد .gitignore
أنشئ ملف .gitignore بدمج قوالب منتقاة لـ 13 لغة و7 أطر عمل وأنظمة macOS وWindows وLinux وأشهر المحررات. تُزال التكرارات تلقائيًا.
ما هو مولّد .gitignore؟
يخبر ملف .gitignore نظام Git بالملفات التي يستبعدها من التحكم في الإصدارات، مثل الاعتماديات ومخرجات البناء والسجلات والأسرار وإعدادات المحررات. حدّد اللغات وأطر العمل وأنظمة التشغيل والمحررات التي يستخدمها مشروعك فتدمج الأداة قوالب منتقاة في ملف .gitignore واحد نظيف، مع إزالة الأنماط المكررة.
كيفية استخدام مولّد .gitignore
- حدّد القوالب التي تحتاجها ضمن لغات البرمجة وأُطر العمل وأنظمة التشغيل والمحررات وبيئات التطوير (استخدم تصفية القوالب للعثور على قالب).
- أضف الأسطر الخاصة بمشروعك ضمن أنماط إضافية.
- انسخ النتيجة أو نزّلها باسم
.gitignoreوضعها في جذر مستودعك.
مثال
Node.js + macOS
# ===== Node.js ===== # Dependencies node_modules/ jspm_packages/ … # Environment .env .env.* !.env.example # ===== macOS ===== .DS_Store .AppleDouble .LSOverride ._* .Spotlight-V100 .Trashes
متى تستخدم مولّد .gitignore
استخدمه عند بدء مستودع أو إضافة أداة جديدة إلى مشروع. لاحظ أن .gitignore يؤثر في الملفات غير المتعقَّبة فقط: إذا كان ملف مودعًا بالفعل فأزله من الفهرس بـ git rm --cached <file> أولًا. أودِع ملف .gitignore نفسه ليشاركه الفريق كله؛ وضع ملفات المحرر الشخصية في gitignore العام لديك إن فضّلت ذلك.
كيف يعمل مولّد .gitignore
القوالب منتقاة من مجموعة github/gitignore الواسعة الاستخدام ومختصرة إلى الأساسيات. تُضم بترتيب ثابت (اللغات ← أطر العمل ← نظام التشغيل ← المحررات)، كلٌّ تحت ترويسة # ===== Name =====. ويُتخطى أي نمط ظهر في قالب سابق، وتُحذف ترويسات التعليقات التي بقيت بلا أنماط، وتُلحق الأنماط الإضافية التي تضيفها تحت قسم Custom إن لم تكن موجودة أصلًا.
حالات الاستخدام الشائعة
- بدء مستودع Node.js أو Python أو Java جديد
- إبعاد ملفات .env والأسرار عن Git
- تجاهل فوضى النظام مثل .DS_Store وThumbs.db
- دمج القواعد لمستودع أحادي (monorepo) بعدة تقنيات
الأسئلة الشائعة
لماذا ما زال الملف متعقَّبًا بعد إضافته إلى .gitignore؟
يتجاهل Git الملفات غير المتعقَّبة فقط. شغّل git rm --cached <file> (أو -r للمجلدات) ثم أودِع التغيير، وسيُتجاهل منذ ذلك الحين.
ماذا تعني البادئة !؟
تعيد تضمين ملف تجاهله نمط سابق، مثل !.env.example الذي يُبقي ملف البيئة النموذجي بينما يتجاهل .env.* بقية الملفات.
هل أتجاهل مجلدات المحررات مثل .vscode؟
يتجاهل قالب VS Code الحالة الشخصية ويُبقي الإعدادات المشتركة والمهام وإعدادات التشغيل والإضافات الموصى بها.