Softonic

مولّد ملفات .gitignore

خطوة 1 / 2
التالي

غياب ملف .gitignore هو السبب في ظهور مفاتيح واجهة برمجة التطبيقات (API) ضمن سجل مستودع Git، وفي رفع مجلد node_modules بحجم 400 ميجابايت إلى GitHub. يُنتج هذا المولّد قالبًا مُختبَرًا مخصصًا لبيئة التطوير الخاصة بك، سواء كانت Node.js أو Python أو Rails أو Laravel، مع استبعاد مجلدات التبعيات ونواتج البناء وملفات البيئة مسبقًا.

كيفية إنشاء ملف .gitignore

  1. 1

    اختر مجموعة تقنياتك

    سواء كانت Node.js أو Python أو Rails أو Laravel، فلكل منها مجموعتها الخاصة من المخلفات المؤقتة.

  2. 2

    ولّد

    تدمج الأداة القواعد الشائعة (.DS_Store، .env، node_modules) مع القواعد الخاصة بكل مجموعة تقنيات.

  3. 3

    احفظ باسم .gitignore

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

  4. 4

    سلّمه (commit)

    يجب تتبع ملف `.gitignore` نفسه؛ فهو جزء من المشروع، وليس تفضيلًا محليًا.

لماذا تكون الكتلة المشتركة موجودة دائمًا

القاعدة سبب التجاهل
.DS_Store بيانات وصفية خاصة بـ Finder في نظام macOS، لا تفيد الأجهزة الأخرى أبدًا
.env أسرار: مفاتيح API، كلمات مرور قواعد البيانات، بيانات اعتماد OAuth
.env.* متغيرات خاصة بالبيئة (التجهيز، الإنتاج)
!.env.example لكن احتفظ بملف المثال ليعرف المساهمون الجدد هيكله
node_modules/ قابل للتثبيت من package.json؛ كبير الحجم وخاص بالمنصة

إضافات خاصة بكل مجموعة تقنيات

المجموعة الإضافات الرئيسية
Node dist/، coverage/، npm-debug.log*
Python __pycache__/، .venv/، *.pyc، .pytest_cache/
Rails log/*، tmp/*، storage/*، /public/assets
Laravel vendor/، /storage/*.key، /public/build، .phpunit.cache/

الأخطاء الشائعة

  • تسليم .env (commit) مبكرًا جدًا ثم إضافته إلى .gitignore. الملف موجود بالفعل في السجل، استخدم git rm --cached .env وغيّر (rotate) كل سر كان موجودًا فيه.
  • تجاهل .env.example مع .env. زملاء الفريق يحتاجون المثال لبدء العمل.
  • أنماط واسعة أكثر من اللازم: قد يُخفي *.log إعدادات سجلات حيوية للإنتاج؛ كن أكثر تحديدًا عند الشك.
  • ملفات خاصة بالمنصة وليست خاصة بك: ساهم بها عبر ملف .gitignore مشترك، وليس عبر ملف شخصي.

gitignore الشخصي مقابل gitignore الخاص بالمشروع

بالنسبة لملفات المحرر الخاصة بك وحدك (مثل JetBrains IDEs أو Emacs)، استخدم ملف gitignore العام الخاص بك (~/.config/git/ignore) بدلًا من تضخيم ملف كل مشروع على حدة.

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

لأن .gitignore يمنع فقط إضافة الملفات غير المتتبَّعة. لإيقاف تتبع ملف سبق تسليمه (committed)، شغّل الأمر git rm --cached path/to/file، ثم سلّم التغيير؛ وبعد ذلك ستستبعده القاعدة.

لا؛ يجب تثبيت ملفات القفل (lockfiles) لضمان تثبيت نفس الإصدارات بدقة في جميع البيئات. إهمالها يؤدي إلى عودة نوع الأخطاء المعروف بـ“يعمل على جهازي“.

الشرطة المائلة البادئة تثبّت النمط على جذر المستودع. يتطابق /logs فقط مع دليل logs/ في المستوى الأعلى، بينما يتطابق logs مع أي دليل باسم logs مهما كان عمقه.

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

أدوات ذات صلة

مرجع جدول ASCII

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

مرجع أحرف HTML

قائمة قابلة للبحث بكيانات HTML، مع رموزها المسمّاة والرقمية، بالإضافة إلى خيار النسخ بنقرة واحدة للأحرف والرموز الخاصة.

مرجع اختصارات لوحة المفاتيح

ابحث في الاختصارات الافتراضية الموثقة لـ VS Code وChrome وBash مع GNU Readline على macOS وWindows وLinux.

مولد EditorConfig

أنشئ ملف .editorconfig بقواعد نمط المسافة البادئة وحجمها ونهاية السطر ومجموعة الأحرف والمسافات البيضاء، لتنسيق موحّد عبر بيئات التطوير المتكاملة (IDEs) والمحررات.

مدقق البريد الإلكتروني

تحقق من عنوان بريد إلكتروني: فحص صياغة RFC 5322، واستعلام حي عن سجل MX، بالإضافة إلى تفاصيل الجزء المحلي والنطاق والطول. لا يتم إرسال أي بريد.

منسق HTML

نسّق HTML محلياً في المتصفح بمسافة بادئة من مسافتين أو أربع مسافات. لا يُرفع HTML ولا يُتحقق منه.

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