`.gitignore` فائل کیا ہے اور آپ اسے کیسے استعمال کرتے ہیں؟

Question

Accepted Answer

ایک **.gitignore** فائل Git کو بتاتی ہے کہ کون سی فائلیں اور ڈائریکٹریز کو **نظرانداز** کریں — ورژن کنٹرول میں ٹریک نہ کریں۔ یہ generated فائلوں، dependencies، secrets، اور environment-specific فائلوں کو خارج کرنے کے لیے استعمال ہوتا ہے جو 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` میں ظاہر نہیں ہوں گی، staged نہیں ہوں گی، اور commit نہیں ہوں گی۔

## Pattern syntax

```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` کو سمجھنا **repositories کو صاف اور محفوظ رکھنے** کے لیے ضروری ہے، بہ ہوالے یہ ضروری عملی Git علم ہے۔

ایک `.gitignore` فائل ان فائلوں کو خارج کرتی ہے جو **ورژن کنٹرول میں نہیں ہونی چاہیں**، کئی حقیقی ضروریات کو پورا کرتے ہوئے۔

یہ repositories کو صاف رکھتا ہے **generated/derived فائلوں** (build output، compiled artifacts) اور **dependencies** (`node_modules`، جو بہت بڑی ہوتی ہے اور manifest فائلوں سے دوبارہ انسٹال ہوتی ہے — انہیں commit کرنے سے repo بھر جاتا ہے) کو خارج کر کے — تاکہ repository میں صرف معنی خیز source ہو۔

یہ **environment-specific اور ذاتی فائلوں** (OS junk جیسے `.DS_Store`، editor configs) کو خارج کرتا ہے جو repository کو بھر دیں گی اور شور پیدا کریں گی۔

سب سے اہم بات یہ ہے کہ یہ **سیکیورٹی** کے لیے ضروری ہے: **secrets** (`.env` فائلیں، credentials، API keys) کو خارج کرنا حیاتی ہے کیونکہ **secrets کو commit کرنا ایک سنگین سیکیورٹی غلطی ہے** — ایک بار commit ہونے کے بعد، secrets repository کی history میں ہوتے ہیں (اور ممکنہ طور پر remote/public repos میں pushed جہاں وہ استحصال ہو سکتے ہیں)، بہ ہوالے `.gitignore` حادثاتی طور پر sensitive data کو commit کرنے سے بچاؤ کی اہم حفاظت ہے۔

**pattern syntax** (directories، wildcards، negation، root-relative) کو سمجھنا آپ کو مؤثر ignore rules لکھنے دیتا ہے، اور یہ معلوم کرنا کہ اہم gotcha ہے کہ **پہلے سے track شدہ فائلوں کو untrack** (`git rm --cached`) کرنا ہوگا `.gitignore` اثر انگیز ہونے سے پہلے عام الجھن سے بچاتا ہے۔

چونکہ صاف repositories (کوئی generated فائلیں، dependencies، یا clutter نہیں) اور خاص طور پر **secrets کو commit نہ کرنا** repository کی معیار اور سیکیورٹی کے لیے اہم ہے، اور `.gitignore` فائلوں کو خارج کرنے کے لیے معیاری طریقہ ہے جو track نہیں ہونی چاہیں، `.gitignore` کو سمجھنا — کیا نظرانداز کریں (dependencies، build output، اور اہم طور پر secrets)، pattern syntax، اور untracking gotcha — صاف، محفوظ repositories برقرار رکھنے کے لیے ضروری، بار بار استعمال ہونے والا Git علم ہے، سیکیورٹی کے پہلو کے ساتھ ورژن کنٹرول سے secrets کو باہر رکھنا خاص طور پر اہم ہونا۔