أنشئ ملف .gitignore من 61 قالبًا للغات البرمجة وأطر العمل والمحررات وأنظمة التشغيل
يعمل في متصفحك. لا يُرسل أي شيء تكتبه إلى أي مكان. تم التحقق في 16 أكتوبر 2026.يسرد ملف .gitignore الملفات التي يجب أن يتركها git دون تتبع، نمطًا واحدًا في كل سطر. اختر القوالب المناسبة لمشروعك، مثل Node.js وmacOS وVS Code، من بين 61 قالبًا رسميًا من github/gitignore؛ فتُدمج في ملف واحد تنسخه أو تنزّله، ويمكن اختبار أي مسار وفق القواعد قبل تنفيذ commit.
تُرجمت هذه الصفحة آليًا من الأصل الإنجليزي. لم يراجع أي شخص هذه الترجمة بعد، لذا فالنسخة الإنجليزية هي التي يُعتمد عليها. اقرأ الأصل الإنجليزي
انقر على قوالب مشروعك، مثل Node.js وmacOS وVS Code، أو ابحث عن قالب باسمه.
أضف أسطرك الخاصة، مثل *.pem أو scratch/، في مربع قواعدك الخاصة.
اكتب بعض المسارات تحت اختبار المسارات لترى أيها سيتجاهله git وأي قاعدة تحسم ذلك.
انقر نسخ أو تنزيل، واحفظ الملف باسم .gitignore في المجلد الأعلى للمستودع.
يحتاج كل مستودع جديد إلى ملف .gitignore قبل أول commit، وإلا انتهت مخرجات البناء والاعتماديات وإعدادات المحرر في السجل. ينشر GitHub قالبًا واحدًا لكل لغة وإطار عمل ومحرر ونظام تشغيل؛ وتضم هذه الصفحة 61 منها، عند commit ثابت، وتدمج القوالب التي تنقر عليها في ملف واحد.
دمج بلا مفاجآت. تتداخل القوالب: فـ Node.js وNext.js وNestJS كلها تتجاهل ملفات السجل. لا يُحذف السطر المكرر إلا إذا لم تقع أي قاعدة ! بين النسختين، فيتجاهل الملف المدمج بالضبط ما تتجاهله القوالب واحدًا تلو الآخر. وتذكر الصفحة عدد الأسطر التي حذفتها.
اختبار المسارات. اكتب المسارات تحت اختبار المسارات، مسارًا في كل سطر، مع شرطة مائلة في نهاية المجلد. يُعلَّم كل مسار بأنه متجاهَل أو محفوظ، مع رقم السطر والقاعدة التي حسمت ذلك. تتبع المطابقة قواعد git نفسها:
| النمط | يطابق | لا يطابق |
|---|---|---|
*.log |
debug.log، logs/app.log |
log.txt |
build/ |
المجلد build في أي عمق |
ملفًا اسمه build |
/dist |
dist في المستوى الأعلى فقط |
src/dist |
doc/*.txt |
doc/a.txt |
doc/sub/a.txt |
**/secrets/** |
api/secrets/key.pem |
secrets نفسه |
!keep.log |
يعيد keep.log |
ملفًا داخل مجلد متجاهَل |
الملف داخل مجلد متجاهَل يبقى متجاهَلًا. لا ينظر git داخل مجلد متجاهَل، لذا لا أثر لـ !secret/ok.txt بعد secret/. اكتب secret/* بدلًا منه، فيعمل سطر !.
الملفات المتتبَّعة مسبقًا. لا يؤثر ملف .gitignore إلا في الملفات غير المتتبَّعة. إذا سبق تنفيذ commit لملف، فأزله من الفهرس بالأمر git rm --cached ثم نفّذ commit؛ ويبقى الملف على قرصك.
جرى التحقق من أداة اختبار المسارات مقارنةً بـ git check-ignore على أكثر من 1,000 مسار، عبر مجموعات قواعد مكتوبة يدويًا وقوالب حقيقية. يعمل كل شيء في متصفحك؛ ولا يُرسل أي شيء تكتبه إلى أي مكان.
احفظه باسم .gitignore، بالنقطة في أوله ودون امتداد، في المجلد الأعلى للمستودع، بجوار المجلد .git. تُقرأ الأنماط التي تحتوي على شرطة مائلة في بدايتها أو وسطها انطلاقًا من ذلك المجلد. ويعمل ملف .gitignore في مجلد فرعي أيضًا، ولا يسري إلا على ما تحته.
لا يؤثر ملف .gitignore إلا في الملفات التي لم يتتبعها git بعد. فبمجرد تنفيذ commit لملف، يواصل git تتبعه. نفّذ git rm --cached متبوعًا بالمسار، ثم نفّذ commit، ومن حينها تسري القاعدة. يبقى الملف على قرصك؛ ولا تُزال إلا نسخته في الفهرس.
تجاهل محتويات المجلد بدلًا من المجلد نفسه: اكتب logs/* ثم !logs/keep.txt. أما إذا كتبت logs/، فإن git يتخطى المجلد كله دون النظر داخله، فلا يستطيع سطر ! إعادة الملف أبدًا. ويُظهر مربع اختبار المسارات الحالة التي أنت فيها.
الشرطة المائلة في النهاية تقصر النمط على المجلدات، فيتجاهل build/ مجلدًا اسمه build لكن لا يتجاهل ملفًا. والشرطة المائلة في البداية أو الوسط تربط النمط بمجلد ملف .gitignore، فيتجاهل /dist مجلد dist في المستوى الأعلى فقط. ومن دون شرطة مائلة يطابق النمط في أي عمق.
نعم. النصوص الـ 61 مأخوذة دون تعديل من المستودع github/gitignore عند commit ثابت، وهي المجموعة التي يستخدمها GitHub عند إنشاء مستودع، ومنشورة بموجب ترخيص CC0. ويحمل كل جزء في النتيجة اسم القالب عنوانًا له، لتعرف مصدر كل قاعدة.
نعم، كما يفعل git على Linux وفي معظم أنظمة CI، لذا لا يطابق Build/ مجلدًا اسمه build. وعلى Windows وmacOS، يضبط git عادةً core.ignorecase على true ويتجاهل حالة الأحرف، فقد يطابق النمط محليًا دون أن يطابق على خادم البناء. اكتب الأنماط بحالة الأحرف الدقيقة لأسماء الملفات.
تتغير المعدلات والقواعد؛ راجع المصدر قبل الاعتماد على أي رقم.
هل ما زلت عالقًا؟ اسأل عن مولّد ملف .gitignore ويمكن لأي شخص يعرف الإجابة أن يجيب. لا حاجة إلى حساب.