العربية
أنشئ ملف .gitignore نظيفاً لأي بنية — لغات وأطر و IDE وأنظمة تشغيل.
آخر تحديث
# Node.js
node_modules/
npm-debug.log*
yarn-debug.log*
yarn-error.log*
pnpm-debug.log*
.pnpm-store/
.npm
.yarn-integrity
# Coverage
coverage/
*.lcov
.nyc_output
# Build output
dist/
build/
# Environment
.env
.env.local
.env.*.local
# macOS
.DS_Store
.AppleDouble
.LSOverride
Icon
._*
.DocumentRevisions-V100
.fseventsd
.Spotlight-V100
.TemporaryItems
.Trashes
.VolumeIcon.icns
.com.apple.timemachine.donotpresent
كل مستودع Git يحتاج إلى ملف .gitignore. هو القائمة النصية للمسارات التي **لا يجب** على Git تتبّعها — مخرجات البناء، مجلّدات الاعتماديات، إعدادات IDE، فضلات نظام التشغيل مثل .DS_Store. بدونه يَسحب أول كومِت لك بطريق الخطأ node_modules/ و .env و target/، وتنظيف هذه الفوضى أكثر إزعاجاً من ضبط الملف من البداية.
كل منظومة تتجاهل أشياء مختلفة، ومعظم المشاريع تجمع عدّة منها معاً. تطبيق Node + TypeScript نموذجي على macOS مع VS Code يحتاج أصلاً إلى اتحاد أربع قوائم تجاهل مختلفة. كتابة هذا من الذاكرة تعني نسيان coverage/، أو تسريب .env، أو إدخال .idea/ تابع لزميل يستخدم JetBrains.
لذلك يجمع هذا المولّد قوالب منقّحة من المشروع المرجعي github/gitignore — نفس المصدر الذي تستخدمه اقتراحات GitHub الرسمية — ويسمح لك بتركيبها معاً. أشّر المربعات، ويُخرِج لك أداةً واحدةً .gitignore مُزال التكرار تلصقها مباشرةً في المستودع. لا حسابات ولا تحميل، كل شيء داخل المتصفح.
.gitignore تستخدم صياغة glob: *.log تتجاهل كل ملف log، و build/ تتجاهل مجلداً، و !important.log تعيد تضمين ملف معيّن حتى لو طابقه glob..gitignore — .gitignore داخل src/ يؤثّر فقط على الملفات تحت src/.node_modules/ ثم أضفته إلى .gitignore، تحتاج أيضاً إلى git rm -r --cached node_modules لإلغاء تتبّعه.إذا كان مشروعك يطابق توليفة شائعة — Next.js أو Django أو Rails — انقر إعداداً مسبقاً لتأشير كل المربعات ذات الصلة دفعةً واحدة. ثم أضف أو احذف القليل بحسب الحاجة.
لكل لغة مخرجاتها التي تُتجاهَل: Node فيها node_modules/، Python فيها __pycache__/ والبيئات الافتراضية، Java فيها target/ و .class. اختر اللغات التي يُجَمّع مشروعك فعلاً.
فوق قواعد اللغة، تضيف أطر العمل مجلّدات بنائها الخاصة: Next.js يريد .next/ و .vercel، Django يريد staticfiles/ و db.sqlite3، Rails يريد tmp/ و /storage/*. أشّر ما تستخدمه.
أضف قوالب المحرّرات التي يستخدمها **الفريق** (لا أنت فقط) — إن كان أحد ما يستخدم JetBrains أو Vim، ضمِّنها. ثم أضف أنظمة تشغيل الفريق: macOS يترك .DS_Store، وWindows يترك Thumbs.db، وكلاهما يسهل كومِته من غير قصد.
تُظهر اللوحة اليمنى المخرج المدمج ومُزال التكرار. انقر **انسخ** لتلصقه مباشرةً في .gitignore بجذر المستودع، أو **نزّل** لحفظ الملف مباشرة.
الأنماط التي ستكتبها أكثر. المرجع الكامل: git-scm.com/docs/gitignore.
| النمط | المعنى | مثال |
|---|---|---|
node_modules | تجاهل ملفاً أو مجلداً بهذا الاسم في أي مكان من الشجرة | يلتقط /node_modules و src/node_modules معاً |
node_modules/ | شرطة في النهاية — يطابق **مجلداً** فقط، لا ملفاً بنفس الاسم | لا يلتقط ملفاً سُمِّي بـ node_modules خطأ |
/build | شرطة في البداية — يثبّت إلى دليل .gitignore فقط | يلتقط /build لا src/build |
*.log | Glob — يلتقط أي ملف ينتهي بـ .log | يلتقط error.log و debug.log و logs/foo.log |
!important.log | نفي — يُعيد تضمين ملف التقطته قاعدة سابقة | ادمجه مع *.log لإبقاء ملف log واحد متعقّباً |
docs/**/draft | نجمة مزدوجة — تلتقط draft في أي مجلّد فرعي تحت docs/ | تلتقط docs/v1/draft و docs/2025/q1/draft |
# comment | تعليق — يتجاهل Git السطور التي تبدأ بـ # | اجمع القواعد بعناوين أقسام مثل # Node.js |
# Node.js node_modules/ npm-debug.log* dist/ .env .env.local # macOS .DS_Store ._*
الحد الأدنى لأي مشروع Node مُشارَك مع زميل على macOS. حتى مشروع جانبي صغير يجب أن يمتلك هذه القواعد — بدون .DS_Store و node_modules/ ستحارب تعارضات بلا معنى.
# Python __pycache__/ *.py[cod] .venv .pytest_cache/ # Django *.log local_settings.py db.sqlite3 media/ staticfiles/ # JetBrains .idea/ *.iml
خلفية Django نموذجية مطوَّرة في PyCharm. لاحظ تجاهل db.sqlite3 المحلي — لا يستعمله الإنتاج، وكومِته يسرّب بيانات التطوير ويُعطب النسخ الجديدة لدى الزملاء.
*.log !keep-me.log
السطر الأول يتجاهل كل .log. قاعدة !keep-me.log تُعيد تضمين هذا الملف بالذات. النفي لا يعمل إلا للملفات التي تجاهلتها قاعدة سابقة — لا يمكنك إعادة تضمين ملف داخل مجلّد متجاهَل.
.gitignore بعد فوات الأوان وتوقّع اختفاء الملفات المكومَتة. لا تختفي — تحتاج إلى git rm -r --cached <مسار> لإلغاء تتبّعها..env ولو مرّةً واحدة. كومِت واحد يُبقي السر في تاريخ المستودع للأبد. أضف .env* إلى .gitignore **قبل** أول كومِت، ودوّر أي سر تسرّب..DS_Store، ستظهر هذه الملفات في كل diff لطلب سحب..gitignore مُعَدّ لكي يُدار بنظام النسخ ويُشارَك مع الفريق. هو *العقد* حول ما يُتعقَّب وما لا يُتعقَّب. الاستثناء هو التفضيلات الشخصية (مثل اختيار محرّرك) — تذهب إلى ~/.gitignore_global العام لديك..gitignore، ثم نفّذ git rm --cached <مسار> (أو git rm -r --cached <مجلد>) لإزالته من الفهرس دون حذفه من القرص. كومِت التغييرَين معاً ليرى زملاؤك التحديث..gitignore في كل دليل ويُطبّق القواعد على ذلك الشجيرة الفرعية. مفيد في monorepos حيث للواجهة الأمامية والخلفية قواعد تجاهل مختلفة جداً — قواعد مشتركة في الجذر وقواعد لغوية في كل حزمة..gitignore يُكومَت ويُشارَك مع الفريق. أما .git/info/exclude فيعيش فقط في نسختك المحلية ويُستخدم لاستثناءات شخصية لا تريد دفعها. للاستثناءات عبر كل مستودعاتك، استخدم ~/.gitignore_global العام.