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

إنشاء مجلد مخرجات في Finder

افتح مجلد المستودع في Finder وأنشئ مجلدًا للمخرجات المُنشأة، مثل build أو dist، باستخدام ملف > مجلد جديد أو Shift-Command-N. احتفظ بملفات المصدر في مواقعها الحالية واضبط أداة البناء لديك لكتابة مخرجاتها في ذلك المجلد. يجب أن يتطابق اسم المجلد مع مسار المخرجات الفعلي للأداة؛ فمجرد إنشاء مجلد بمفرده لا يعيد توجيه عملية البناء. توثق Apple خطوات إنشاء المجلدات في Finder في دليل تنظيم الملفات في Finder.

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

إضافة المجلد المُنشأ إلى .gitignore

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

/build/

تقوم الشرطة المائلة البادئة بتثبيت هذا النمط في جذر المستودع، وتجعله الشرطة المائلة اللاحقة يطابق دليلاً. إذا كانت مخرجاتك المُنشأة متداخلة، فاستخدم مسارها بدلاً من ذلك، مثل /app/generated/. تشرح وثائق gitignore الخاصة بـ Git مطابقة الأنماط وتوضح أن القواعد العامة للمشروع تنتمي إلى .gitignore حتى يمكن مشاركتها مع النسخ المستنسخة الأخرى.

بالنسبة لمجلد مُنشأ محليًا لا ينبغي أن يؤثر على الأشخاص الآخرين الذين يعملون على المستودع، أضف قاعدته إلى .git/info/exclude بدلاً من ذلك. يوثق Git هذا كبديل خاص بالمستودع لملف .gitignore. استخدم قاعدة .gitignore مُودعة عندما يتم إنشاء المخرجات لجميع العاملين في المشروع ويجب استبعادها لكافة المساهمين.

تأكيد القاعدة والتعامل مع الملفات المتتبعة بالفعل

افتح Terminal وانتقل إلى دليل المستودع. تحقق من الحالة، ثم اسأل Git عن القاعدة التي تنطبق على مسار مُنشأ:

git status --short
git check-ignore -v build/example-file

استبدل build/example-file بمسار موجود أسفل مجلد المخرجات لديك. يُبلغ الخيار -v عن قاعدة التجاهل المطابقة والملف الذي يحتوي عليها. إذا أبلغ Git عن عدم وجود تطابق، فتأكد من المسار والنمط: يتم تفسير المسارات في .gitignore بالنسبة لموقع الملف، وقد يتم تجاوز قاعدة بواسطة قاعدة مطابقة أخرى. يصف مرجع check-ignore الخاص بـ Git كيفية فحص مطابقات التجاهل.

لا توقف قاعدة التجاهل تتبع الملفات التي تم إيداعها بالفعل أو إدراجها في مرحلة التجهيز (staged) في Git. يوضح Git صراحةً أن الملفات المتتبعة لا تتأثر بقواعد التجاهل. لإزالة ملف مُنشأ تم تتبعه مسبقًا من الفهرس مع ترك النسخة المحلية في مكانها، استخدم git rm --cached مع المسار الدقيق، ثم راجع التغيير قبل الإيداع. على سبيل المثال:

git rm --cached build/example-file
git status --short

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

استخدام Finder لمعاينة الأسماء، وليس لفرض قواعد Git

يمكن لـ Finder تسهيل فحص أنواع الملفات: اختر Finder > الإعدادات > متقدم وفعّل إظهار كل ملحقات أسماء الملفات. يمكن أن يساعد ذلك في التمييز بين ملف المصدر والملف المُنشأ عندما تكون أسماؤهما متشابهة. تشير Apple إلى أن الملحقات قد تكون مخفية بخلاف ذلك وتنصح بعدم تغيير ملحق اسم الملف لمجرد تغيير تنسيق الملف. راجع تعليمات إظهار أو إخفاء ملحقات أسماء الملفات المقدمة من Apple.

وبالتالي فإن التقسيم الموثوق به هو: يوفر Finder مجلدًا مرئيًا للمخرجات المُنشأة، وتكتب أداة البناء هناك، وتستبعد قواعد تجاهل Git الملفات غير المتتبعة المؤهلة من نظام التحكم في الإصدار. تحقق من مسار المخرجات الفعلي وحالة Git كلما تغير تكوين بناء المشروع.

المصادر