Softonic

مولّد ملف .gitignore

الخطوة 1 / 2
تقنيات المشروع

اختر جميع التقنيات المستخدمة في هذا المستودع.

قواعد شخصية

يُفضّل عادةً وضع قواعد نظام التشغيل والمحرر في ملف الاستبعاد العام في Git.

التالي: مراجعة القواعد

اختر التقنيات المستخدمة في مستودعك لإنشاء ملف .gitignore للمشروع يستبعد الملفات المُنشأة والتبعيات وملفات البيئة المحلية. يمكنك اختيار أكثر من تقنية. تظهر قواعد نظام التشغيل والمحرر الاختيارية بصورة منفصلة حتى تتمكن من وضع تفضيلاتك الشخصية في ملف الاستبعاد العام في Git.

إنشاء قواعد الاستبعاد واستخدامها

  1. 1

    اختر تقنيات المشروع

    حدّد جميع التقنيات في المستودع، مثل Laravel وNode.js لتطبيق PHP يتضمن عملية بناء للواجهة الأمامية.

  2. 2

    أضف قواعد شخصية عند الحاجة

    اختر نظام التشغيل أو المحرر لعرض مجموعة منفصلة من الاستبعادات العامة. اترك هذه الخيارات فارغة إذا كان ملفك العام الحالي يشملها.

  3. 3

    راجع القواعد، ثم انسخها أو نزّل ملف ZIP

    افحص قواعد المشروع. انسخها إلى ملف `.gitignore` في جذر المستودع، أو نزّل ملف ZIP واستخرج منه `.gitignore` إلى جذر المستودع. ضع أي قواعد شخصية اختيارية في ملف الاستبعاد العام في Git.

  4. 4

    تحقّق قبل تسجيل التغييرات

    سجّل ملف `.gitignore` الخاص بالمشروع في Git ليصل إلى زملائك. تأكد من أن Git لا يزال يعرض الملفات التي تريد الاحتفاظ بها، خصوصًا ملفات الأمثلة وملفات تثبيت إصدارات التبعيات.

أين توضع كل قاعدة؟

نوع القاعدة موضعها المناسب مثال
مخرجات المشروع المُنشأة والتبعيات المثبّتة ملف .gitignore محفوظ في سجل المستودع node_modules/ وvendor/ و__pycache__/
قيم البيئة المحلية ملف .gitignore الخاص بالمشروع .env والنسخ المحلية التي تطابق .env.*
الملفات الخاصة بنظامك ومحررك ملف الاستبعاد العام في Git، أو .git/info/exclude لمستودع واحد بيانات Finder الوصفية أو نُسخ المحرر الاحتياطية
الملفات التي يحتاجها المتعاونون أبقها متتبَّعة عند الحاجة .env.example وpackage-lock.json وcomposer.lock وGemfile.lock

يقرأ Git ملفات .gitignore الخاصة بالمشروع وملف .git/info/exclude المحلي للمستودع والملف الشخصي المحدد بواسطة core.excludesFile. تنتقل قاعدة المشروع مع المستودع عند تسجيل ملف .gitignore في Git، بينما تُطبَّق القاعدة الشخصية عادةً على جهازك فقط. راجع دليل Git لقواعد الاستبعاد ودليل GitHub لتجاهل الملفات.

مثال عملي: خدمة Node.js مع نصوص Python

اختر Node.js وPython. يجمع ملف المشروع قواعد للحزم المثبّتة مثل node_modules/، ومخرجات بناء Node مثل dist/، والملفات التي ينشئها Python مثل __pycache__/ و.venv/. ويستبعد أيضًا قيم .env المحلية مع إتاحة حفظ .env.example في المستودع. إذا كنت تستخدم Mac وVisual Studio Code، فاختر هذين الخيارين الشخصيين لمراجعة قواعدهما بصورة منفصلة. قارن الناتجين بمحتويات مستودعك الفعلية قبل حفظهما.

يعتمد المولّد على القوالب التي اخترتها؛ فهو لا يفحص ملفاتك ولا يستطيع معرفة ما إذا كان مجلد باسم dist/ يحتوي على مخرجات بناء أم على ملفات مصدر تريد حفظها في Git. خصّص أي قاعدة أو احذفها إذا تعارضت مع مشروعك. استخدم git check-ignore -v path/to/file لمعرفة القاعدة التي تنطبق على ملف غير متتبَّع. تُعد مجموعة قوالب GitHub مرجعًا مفيدًا لأعراف التقنيات والمحررات، لكنها لا تغني عن مراجعة مستودعك.

ملفات البيئة وملفات تثبيت إصدارات التبعيات

يساعد استبعاد .env على منع إدراج بيانات الاعتماد المحلية في عمليات التسجيل الجديدة، لكنه لا يزيل سرًا سبق تسجيله. إذا كان السر موجودًا في سجل Git، فأوقف تتبّع الملف، وتحقّق من المواضع التي نُسخ إليها، وغيّر بيانات الاعتماد. احتفظ بملف .env.example منقّى فقط إذا احتوى على قيم افتراضية بدلًا من أسرار حقيقية. يتضمن ملف .gitignore المُنشأ الاستثناء !.env.example من النمط .env.*؛ أبقِ هذا الاستثناء عند تعديل القواعد حتى يظل ملف المثال قابلًا للتتبّع.

احتفظ في التطبيقات بملفات تثبيت إصدارات التبعيات حتى يمكن إعادة تثبيت الإصدارات المختارة. توصي npm بتسجيل package-lock.json، كما توصي Composer بتسجيل composer.lock. قد تتبع المكتبات أعرافًا مختلفة لهذه الملفات، لذا اتبع سياسة البناء والإصدار الخاصة بالمشروع.

الأسئلة الشائعة

تؤثر قواعد الاستبعاد في الملفات التي لم يبدأ Git بتتبّعها بعد. لإيقاف تتبّع ملف مع إبقاء نسختك المحلية، نفّذ git rm --cached path/to/file ثم سجّل الإزالة. إذا احتوى الملف على بيانات اعتماد، فغيّرها وراجع سجل المستودع وأي نسخ أخرى.

من الأفضل عادةً إبقاء ملف .env.example منقّى وملفات تثبيت إصدارات تبعيات التطبيقات في Git. يوثّق المثال مفاتيح البيئة المطلوبة، ويثبّت ملف الإصدارات نسخ التبعيات لزملائك ولعمليات النشر. تأكد من خلو المثال من الأسرار الحقيقية.

نعم. اختر كل تقنية مستخدمة في المستودع نفسه. يجمع المولّد قواعد المشروع المختارة في ملف .gitignore واحد؛ راجع أي مسار يُستخدم لغرض مختلف في مشروعك.

استخدم ملف الاستبعاد العام في Git للقواعد الشخصية المطبقة على عدة مستودعات. إذا لم يُضبط XDG_CONFIG_HOME، يستخدم Git المسار ~/.config/git/ignore افتراضيًا؛ ويمكنك تحديد مسار آخر عبر core.excludesFile. لقاعدة خاصة بهذا المستودع وحده، استخدم .git/info/exclude. لا تضف الناتج الشخصي المنفصل إلى ملف المشروع المشترك إلا إذا أراد الفريق تلك القواعد.

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

أدوات ذات صلة

مرجع جدول ASCII

جدول ASCII كامل من 0 إلى 127 مع التمثيل العشري والست عشري والثماني والثنائي والمرجع الرقمي في HTML لكل محرف، بما في ذلك أكواد التحكم مثل NUL وLF وDEL.

أداة إزالة التشفير في لغة جافا سكريبت (JavaScript Deobfuscator)

إزالة التشفير من كود جافا سكريبت مُصغَّر أو مُعبَّأ باستخدام إعادة تسمية المتغيرات، وفك ترميز السلاسل النصية ومصفوفات البيانات، بالإضافة إلى عكس تسطيح تدفق التحكم وتحسين هيكله.

مولّد إعدادات Webpack

أنشئ ملف webpack.config.js لـ webpack 5 من نموذج قصير: حدّد entry ومجلد الإخراج والوضع (mode)، ثم فعّل TypeScript وBabel ومحمّل CSS وHtmlWebpackPlugin وخادم تطوير.

مولد تراخيص

قم بإنشاء النص الكامل لترخيصات المصدر المفتوح مع إدخال اسمك والسنة المقابلة، ويشمل ذلك تراخيص MIT وApache 2.0 وGPLv3 وBSD-3 وMPL-2.0 وCC.

مولّد Dockerfile

أنشئ ملف Dockerfile وملف .dockerignore مطابقًا له لخمس بيئات تطبيقات. أدخل مدخل التشغيل الفعلي ودليل العمل والمنفذ الداخلي، ثم راجع الملفين.

مولد ملف tsconfig.json

أنشئ ملف tsconfig.json نظيفا باختيار target وmodule وmoduleResolution وJSX وأعلام الصرامة الشائعة، ثم انسخ الإعداد المولّد إلى مشروعك.

الأداة متاحة بلغات أخرى