.gitignore چیست؟

خب .gitignore یک فایل متنی ساده است که به Git می‌گوید چه فایل‌ها و پوشه‌هایی را نباید وارد مخزن (Repository) کند و آن‌ها را Track نکند.

این فایل معمولاً در روت پروژه و کنار فایل package.json قرار می‌گیرد.

چرا .gitignore مهم است؟

1. جلوگیری از سنگین شدن ریپو

پوشه‌هایی مانند node_modules بسیار حجیم هستند و نباید داخل Git ذخیره شوند.

2. جلوگیری از انتشار اطلاعات حساس

فایل‌هایی مثل .env ممکن است شامل کلیدهای API یا اطلاعات محرمانه باشند.

3. جلوگیری از شلوغ شدن کامیت‌ها

فایل‌های build، cache و log دائماً تغییر می‌کنند و باعث ایجاد تغییرات غیرضروری در commitها می‌شوند.

چطور از .gitignore استفاده کنیم؟

مرحله 1: فعال بودن Git در پروژه

اگر پروژه Git ندارد:

git init

مرحله 2: ساخت فایل

در روت پروژه فایل زیر را بسازید:

touch .gitignore

مرحله 3: اضافه کردن به Git

git add .gitignore
git commit -m "Add gitignore"

نمونه کانفیگ .gitignore برای React

# dependencies
node_modules/

# production builds
dist/
build/

# logs
npm-debug.log*
yarn-debug.log*
yarn-error.log*
pnpm-debug.log*
*.log

# env files (secrets)
.env
.env.*
!.env.example

# local editor settings
.vscode/
.idea/
*.swp
*.swo

# OS files
.DS_Store
Thumbs.db

# cache
.cache/
.eslintcache

نکات مهم

اگر قبلاً فایلی commit شده باشد

اگر فایلی قبلاً وارد Git شده باشد، اضافه کردن آن به .gitignore کافی نیست.

برای خارج کردن آن از track:

git rm -r --cached dist
git commit -m "Stop tracking dist"

این دستور فقط فایل را از Git حذف می‌کند، نه از سیستم شما.

مشاهده فایل‌های ignore شده

git status --ignored

جمع‌بندی

استفاده از .gitignore باعث می‌شود:

• مخزن Git سبک و تمیز بماند
• اطلاعات حساس وارد مخزن نشود
• و commit ها مرتب‌تر و حرفه‌ای‌تر باشند