تجاهل الملفات والدلائل في git (.gitignore)

في كثير من الأحيان ، عند العمل في مشروع يستخدم Git ، سترغب في استبعاد ملفات أو أدلة محددة من الدفع إلى مستودع التخزين البعيد.

يحدد ملف.gitignore ما هي الملفات التي لم يتم تعقبها والتي يجب على Git تجاهلها.

ما هي الملفات التي يجب تجاهلها؟

عادةً ما تكون الملفات المتجاهلة ملفات خاصة بالنظام الأساسي أو ملفات يتم إنشاؤها تلقائيًا من أنظمة الإنشاء. بعض الأمثلة الشائعة تشمل:

• ملفات وقت التشغيل مثل السجل أو القفل أو ذاكرة التخزين المؤقت أو الملفات المؤقتة. الملفات ذات المعلومات الحساسة ، مثل كلمات المرور أو مفاتيح واجهة برمجة التطبيقات. التعليمات البرمجية المترجمة ، مثل دلائل .class أو .o التبعية ، مثل /vendor أو /node_modules node_modules. ، مثل /public ، /out ، أو /dist . ملفات النظام مثل .DS_Store أو Thumbs.db IDE أو ملفات تكوين محرر النصوص.

.gitignore

عادةً ما يتم وضع ملف .gitignore محلي في الدليل الجذر للمستودع. ومع ذلك ، يمكنك إنشاء ملفات .gitignore متعددة في .gitignore مختلفة في مستودع التخزين الخاص بك. تتم مطابقة الأنماط الموجودة في ملفات .gitignore بالنسبة إلى الدليل الذي يوجد به الملف.

للنماذج المعرفة في الملفات الموجودة في الدلائل ذات المستوى الأدنى (الدلائل الفرعية) الأسبقية على تلك الموجودة في الدلائل ذات المستوى الأعلى.

تتم مشاركة ملفات .gitignore المحلية مع مطورين آخرين ويجب أن تحتوي على أنماط مفيدة لجميع المستخدمين الآخرين لمستودع التخزين.

تجاهل القواعد الشخصية

يجب تعيين الأنماط الخاصة بمستودع التخزين المحلي الخاص بك والتي يجب عدم توزيعها على مستودعات أخرى ، في ملف .git/info/exclude .

على سبيل المثال ، يمكنك استخدام هذا الملف لتجاهل الملفات التي تم إنشاؤها من أدوات المشروع الشخصية.

العالمية

يتيح لك Git أيضًا إنشاء ملف .gitignore عالمي ، حيث يمكنك تحديد قواعد التجاهل لكل مستودع Git على نظامك المحلي.

يمكن تسمية الملف بأي شيء تريده وتخزينه في أي مكان. المكان الأكثر شيوعًا للاحتفاظ بهذا الملف هو الدليل الرئيسي. سيكون عليك إنشاء الملف يدويًا وتهيئة Git لاستخدامه.

على سبيل المثال ، لتعيين ~/.gitignore_global كملف تجاهل Git عالمي ، يمكنك القيام بما يلي:

1. قم بإنشاء الملف:

   touch ~/.gitignore_global

   أضف الملف إلى تكوين Git:

   git config --global core.excludesfile ~/.gitignore_global

   افتح الملف باستخدام محرر النصوص وأضف القواعد إليه.

تعد القواعد العامة مفيدة بشكل خاص لتجاهل ملفات معينة لا ترغب في الالتزام بها ، مثل الملفات ذات المعلومات الحساسة أو الملفات التنفيذية المترجمة.

تجاهل الملفات التي سبق ارتكابها

يمكن تتبع الملفات الموجودة في نسخة العمل الخاصة بك أو إلغاء تعقبها.

لتجاهل ملف تم الالتزام به مسبقًا ، ستحتاج إلى إلغاء تثبيت الملف وإزالته من الفهرس ، ثم إضافة قاعدة للملف في .gitignore :

git rm --cached filename

يخبر الخيار - --cached git بعدم حذف الملف من شجرة العمل ولكن فقط لإزالته من الفهرس.

لإزالة دليل بشكل متكرر ، استخدم الخيار -r :

git rm --cached filename

عند حذف الملفات بشكل متكرر ، استخدم الخيار -n الذي سيؤدي إلى "التشغيل الجاف" ويظهر لك الملفات التي سيتم حذفها:

git rm -r -n directory

تصحيح ملف .gitignore

في بعض الأحيان قد يكون من الصعب تحديد سبب تجاهل ملف معين ، خاصةً عند استخدامك لملفات .gitignore متعددة أو أنماط معقدة. هذا هو المكان الذي يكون فيه الأمر git check-ignore بخيار -v ، والذي يخبر git بعرض تفاصيل حول نمط المطابقة ، مفيدًا.

على سبيل المثال ، للتحقق من سبب تجاهل ملف www/yarn.lock يجب تشغيل:

git check-ignore -v www/yarn.lock

يُظهر الإخراج المسار إلى ملف gitignore ، وعدد خط المطابقة ، والنمط الفعلي.

www/.gitignore:31:/yarn.lock www/yarn.lock

يقبل الأمر أيضًا أكثر من اسم ملف واحد كوسائط ، ولا يجب أن يكون الملف موجودًا في شجرة العمل الخاصة بك.

عرض جميع الملفات المتجاهلة

يعرض الأمر git status مع الخيار --ignored قائمة بجميع الملفات التي تم تجاهلها:

git status --ignored

استنتاج

يسمح لك ملف .gitignore باستبعاد الملفات من أن يتم إيداعه في المستودع. يحتوي الملف على أنماط متقلبة تصف الملفات والدلائل التي يجب تجاهلها.

gitignore.io هي خدمة عبر الإنترنت تتيح لك إنشاء ملفات.gitignore لنظام التشغيل أو لغة البرمجة أو IDE.