ما هو ملف .gitignore وكيف تستخدمه؟

Question

Accepted Answer

ملف **.gitignore** يخبر Git بالملفات والمجلدات التي يجب **تجاهلها** — عدم تتبعها في التحكم بالإصدارات. يُستخدم لاستبعاد الملفات المولدة والمكتبات والأسرار والملفات الخاصة بالبيئة التي لا يجب أن تُُرسل (commit).

## ما الذي يفعله .gitignore

```text
# .gitignore — patterns of files Git should NOT track
node_modules/          # dependencies (reinstalled from package files, don't commit)
dist/                  # build output (generated, don't commit)
*.log                  # log files
.env                   # ⚠️ SECRETS / environment variables — NEVER commit!
.DS_Store              # OS-specific junk
.vscode/               # editor config (often personal)
build/
coverage/
*.tmp
```

يتجاهل Git الملفات المطابقة لهذه الأنماط — لن تظهر في `git status`، ولن يتم ترحيلها (staging)، ولن يتم إرسالها.

## بناء الجملة للأنماط

```text
node_modules/    → ignore a directory (and everything in it)
*.log            → ignore all files with a .log extension
!important.log   → EXCEPTION: do NOT ignore this (negation)
/build           → ignore "build" only in the root (leading slash = root-relative)
doc/*.txt        → .txt files in doc/ but not subdirectories
**/temp          → "temp" anywhere in the tree
```

## ما الذي يجب تجاهله (الفئات الشائعة)

```text
✓ DEPENDENCIES — node_modules/, vendor/ (reinstalled from manifests; huge, don't commit)
✓ BUILD OUTPUT — dist/, build/, *.o (generated from source)
✓ SECRETS — .env, credentials, keys (⚠️ NEVER commit secrets — a serious security issue)
✓ ENVIRONMENT/OS/EDITOR files — .DS_Store, .idea/, .vscode/ (personal/machine-specific)
✓ LOGS, caches, temp files
```

```text
⚠️ Already-tracked files aren't ignored by adding them later — untrack first:
   git rm --cached <file>   (then commit; .gitignore prevents re-adding)
```

## لماذا يهم هذا

فهم `.gitignore` مهم للغاية **للحفاظ على المستودعات نظيفة وآمنة**، لذا فهو معرفة Git عملية أساسية.

ملف `.gitignore` يستبعد الملفات التي **لا يجب أن تكون في التحكم بالإصدارات**، معالجاً عدة احتياجات حقيقية.

يحافظ على نظافة المستودعات باستبعاد **الملفات المولدة/المشتقة** (مخرجات البناء والتحفات المترجمة) و**المكتبات** (`node_modules`، وهي ضخمة وتُعاد تثبيتها من ملفات البيان — إرسالها سيضخم المستودع) — بحيث يحتوي المستودع على المصدر المعنوي فقط.

يستبعد **الملفات الخاصة بالبيئة والملفات الشخصية** (أشياء النظام الجديدة مثل `.DS_Store` وإعدادات المحرر) التي ستزيد من فوضى المستودع وتسبب ضوضاء.

الأهم من ذلك، إنه ضروري **للأمان**: استبعاد **الأسرار** (ملفات `.env`، بيانات الاعتماد، مفاتيح API) أمر حتمي لأن **إرسال الأسرار خطأ أمني خطير** — بمجرد الإرسال، تكون الأسرار في سجل المستودع (وربما دُفعت إلى المستودعات البعيدة/العامة حيث يمكن استغلالها)، لذا يعتبر `.gitignore` دفاعاً رئيسياً ضد الإرسال العرضي للبيانات الحساسة.

فهم **بناء جملة الأنماط** (المجلدات والأحرف البدلية والنفي والنسبية للجذر) يتيح لك كتابة قواعد تجاهل فعالة، ومعرفة الثغرة المهمة وهي أن **الملفات المتتبعة بالفعل يجب إلغاء تتبعها** (`git rm --cached`) قبل أن يسري مفعول `.gitignore` يمنع الالتباس الشائع.

بما أن المستودعات النظيفة (بدون ملفات مولدة أو مكتبات أو فوضى) و خاصة **عدم إرسال الأسرار** مهمة لجودة المستودع والأمان، وبما أن `.gitignore` هي الآلية القياسية لاستبعاد الملفات التي لا يجب تتبعها، فإن فهم `.gitignore` — ما يجب تجاهله (المكتبات ومخرجات البناء والأسرار بشكل حتمي)، وبناء جملة الأنماط، وثغرة عدم التتبع — معرفة Git أساسية وكثيرة التطبيق للحفاظ على المستودعات نظيفة وآمنة، مع كون جانب الأمان المتعلق بإبقاء الأسرار خارج التحكم بالإصدارات مهماً بشكل خاص.