ما هو ملف GITIGNORE وكيف يمكنني استخدامه؟

عند العمل مع مستودع git ، هناك خطر وجود بيانات غير مرغوب فيها. لحسن الحظ ، يمكنك إنشاء ملف بامتداد GITIGNORE وتحديد الملفات والمجلدات التي يجب تجاهلها في المشروع. يمكنك تكوين بيانات GITIGNORE عالمية للاستخدام مع كل مستودع Git.

ما هو ملف GITIGNORE وكيف يمكنني استخدامه؟

كيفية إنشاء ملفات GITIGNORE

ملفات GITIGNORE هي ملفات نصية عادية ، لذا يمكنك فتحها باستخدام برنامج Notepad أو أي محرر نصوص. إليك كيفية إنشاء ملف GITIGNORE:

  1. افتح أي محرر نصوص واضغط على حفظ. قم بتغيير الاسم إلى .gitignore.
  2. عند تحرير الملف ، يتم حجز كل سطر لمجلد واحد أو ملف يجب أن يتجاهله git.

استخدم "#" لإضافة تعليقات إلى ملف .gitignore

استخدم "*" لمطابقة أحرف البدل

استخدم # / ”لتجاهل المسارات المتعلقة بملف GITIGNORE.

كمثال ، يمكن أن يبدو GITIGNORE الخاص بك كما يلي:

# تجاهل مجلد node_modules

node_modules

# تجاهل الملفات المتعلقة بمفاتيح API

.env

# تجاهل ملفات نظام ماك

DS_store

# تجاهل ملفات التكوين SASS

.sass-cache

# تجاهل جميع الملفات النصية

*.رسالة قصيرة

كما تعلم ، التعليقات اختيارية.

تجاهل الدلائل بتضمين مساراتها واستخدام "/" في نهاية كل سطر.

فمثلا:

اختبارات/

السجلات/

الأحمال /

بينما يمكن استخدام رمز حرف البدل "*" لتجاهل جميع الملفات ذات الامتداد المحدد ، يمكنك دمجه مع رمز النفي "!". هنا مثال:

*.رسالة قصيرة

! readme.txt

! main.txt

ما سبق يُعلم git بتجاهل كل ملف بامتداد txt. باستثناء readme.txt و main.txt.

يمكن استخدام أحرف البدل للأدلة. فقط كن حذرًا عند استخدامها ، كما هو موضح في هذا المثال:

اختبار/

! test / example.txt

قد تعتقد أن git سيتجاهل الآن كل ملف داخل دليل "test" باستثناء "example.txt". ومع ذلك ، هذا ليس هو الحال. سيستمر تجاهل example.txt لأسباب تتعلق بالأداء ، حيث حددنا أنه يتم تجاهل دليل "الاختبار" بأكمله.

لديك خيار استخدام علامة النجمة المزدوجة (**) لمطابقة أي عدد من الدلائل والملفات. على سبيل المثال ، سيقوم Test / ** / *. txt بإخبار git بتجاهل الملفات التي تنتهي بـ .txt فقط في دليل الاختبار والأدلة الفرعية الخاصة به.

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

ثلاث طرق لتنفيذ ملفات GITIGNORE

استخدم GITIGNORE عالميًا مع جميع مشاريعك ، إما مع زملائك أو بمفردك. ومع ذلك ، يمكنك إنشاء GITIGNORE محلي أو حتى تحديد قواعد الاستبعاد.

قم بإنشاء ملف GITIGNORE محلي

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

قم بإنشاء ملف GITIGNORE عالمي

إذا كنت تعمل مع مستودعات git المتعددة ، فيمكنك توفير الكثير من الوقت من خلال تحديد القواعد العامة لمستودعاتك المحلية.

  1. قم بإنشاء ملف GITIGNORE وحدد القواعد العامة للتطبيق.
  2. استخدم خاصية core.excludesFiles لتحويل ملف GITIGNORE المحلي إلى ملف عام. استخدم السطر التالي:

git config – global core.excludesFile

أنشئ قواعد GITIGNORE الشخصية

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

استخدام ملف GITIGNORE للملفات المعينة

تجاهل الملفات الملتزم بها

يتم دمج الملفات الملتزم بها في المستودع حيث يتم تخزينها مؤقتًا. إذا تجاهلت هذه البيانات ، فيجب إزالتها أولاً. الطريقة المقترحة للقيام بذلك هي حذف هذه الملفات ثم الالتزام وتطبيق التغييرات. بمجرد القيام بذلك ، يمكنك أخيرًا استخدام GITIGNORE من خلال تحديد قاعدة حيث سيتم تجاهل الملف محليًا. أضف هذا الخط:

بوابة rm - مؤقت

بهذه الطريقة ، ستتم إزالة الملف من المستودع على الرغم من بقائه في دليل العمل. يجب أن يكون ملف GITIGNORE بهذه القاعدة في دليل العمل.

الالتزام بالملف الذي تم تجاهله سابقًا

إذا كنت ترغب في تنفيذ ملف تم تجاهله ، يمكنك تنفيذ ذلك باستخدام سطر "git add" وخيار "force". على سبيل المثال ، إذا كنت تريد إزالة example.txt من ملف GITIGNORE مع الاحتفاظ بالمستودع ملتزمًا به ، فأدخل الأسطر:

git add -f example.txt

git الالتزام -m "فرض إضافة example.txt".

لقد أضفت الآن ملفًا تم تجاهله إلى المستودع. الخطوة الأخيرة هي تعديل ملف GITIGNORE عن طريق إزالة نمط التجاهل أو القاعدة.

ما هو ملف GITIGNORE كيفية استخدام واحد

استخدم GITIGNORE لصالحك

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

كم مرة تحتاج إلى ملفات GITIGNORE في مستودع git؟ هل تستخدم في الغالب القواعد العالمية أو المحلية؟ يرجى مشاركة خبراتك في قسم التعليقات.