الدليل الكامل لصياغة أنماط .gitignore

كل سطر في ملف .gitignore هو نمط واحد. تبدو الصياغة شبيهة بأنماط glob في الصدفة، لكن معناها يتغير كثيرًا بحسب موضع الشرطات المائلة وموضع **. يستند المحتوى أدناه إلى وثائق git الرسمية gitignore(5)، وقد جرى التحقق من الأمثلة مباشرةً باستخدام git 2.50.

الأسطر الفارغة والتعليقات والهروب

• السطر الفارغ لا يطابق أي شيء. استخدمه فاصلًا لتسهيل القراءة.
• السطر الذي يبدأ بـ # تعليق. لتجاهل ملف يبدأ اسمه بـ # أضف شرطة مائلة عكسية مثل \#.
• المسافات في نهاية السطر تُتجاهل. إن احتجت إلى اسم ملف ينتهي بمسافة فاحمِ المسافة بشرطة مائلة عكسية مثل foo\ . أما المسافات في بداية السطر فتبقى جزءًا من النمط.
• السطر الذي يبدأ بـ ! نمط نفي. للملف الذي يبدأ اسمه بـ ! اكتب \!important.txt.

المسافات في نهاية السطر غير مرئية وهي سبب شائع للأخطاء. إن لم تعمل قاعدة ما ففعّل إظهار المسافات في المحرر. وتذكّر أن حرف المسافة وحده هو ما يُحذف، أما علامات الجدولة فلا.

الشرطة المائلة الأخيرة: المجلدات فقط

إذا انتهى النمط بـ / فإنه يطابق المجلدات فقط. يتجاهل build/ المجلد build وكل ما فيه، لكنه لا يتجاهل ملفًا اسمه build. وبالعكس، build بلا شرطة يطابق الملفات والمجلدات التي تحمل هذا الاسم.

الشرطة المائلة تثبّت الموضع

إذا احتوى باقي النمط، بعد استبعاد الشرطة الأخيرة، على / في البداية أو في الوسط، فلا يطابق النمط إلا المسارات النسبية إلى المجلد الذي يحتوي ملف .gitignore. يُسمّى هذا غالبًا التثبيت (anchoring). ومن دون / يبحث git عن العناصر المطابقة للاسم على أي عمق تحت ملف .gitignore.

الصف الثالث هو الأكثر إرباكًا. يحتوي logs/debug.log على شرطة في الوسط، فيُثبَّت في الجذر ويعادل إضافة / في أوله. لالتقاط logs/debug.log على أي عمق استخدم **/logs/debug.log.

أحرف البدل: * و? و[ ]

• يطابق * أي سلسلة عدا / (بما في ذلك السلسلة الفارغة). يطابق *.log كلًّا من app.log وa/b/app.log، لكن logs/*.log يطابق logs/app.log فقط وليس logs/2026/app.log.
• يطابق ? حرفًا واحدًا عدا /. يطابق file?.txt الملف file1.txt ولا يطابق file10.txt.
• يطابق [a-z] حرفًا واحدًا داخل النطاق، ويطابق [!a-z] أو [^a-z] حرفًا واحدًا خارجه. يلتقط *.py[cod] الامتدادات .pyc و.pyo و.pyd دفعة واحدة. والأقواس المربعة لا تطابق / أيضًا.
• يمكن كذلك استخدام فئات أحرف POSIX مثل [[:digit:]].

النجمتان **

لا يحمل ** معنى خاصًا إلا عندما يلتصق بشرطات مائلة.

في المواضع الأخرى، مثل ** في foo** أو **bar، يتصرف كـ * عادية ولا يعبر الشرطات المائلة. يطابق docs/**/*.pdf كلًّا من docs/manual.pdf وdocs/a/b/manual.pdf لأن /**/ يطابق صفر مجلدات أيضًا.

خلاصة في مثال صغير

# Build output (only the build directory at the root)
/build/

# Log files at any depth, but keep the important log
*.log
!important.log

# All PDFs under docs
docs/**/*.pdf

# A file whose name starts with #
\#scratch.md

يمكنك إعادة إنتاج هذا الجدول تمامًا بلصق القواعد والمسارات في تبويب اختبار الأنماط في المولّد.

المراجع

• وثائق gitignore الرسمية (git-scm.com)
• GitHub Docs: Ignoring files
• تاريخ التحقق: 2026-09-23 (جرى التحقق من الأمثلة باستخدام git 2.50.1)