نمایش مبدأ برای بحث رده:Git

== Git ==
[[Category:Git]]

Git یه سیستم '''کنترل نسخه (Version Control System)''' هست که بهت اجازه میده تاریخچه‌ی تغییرات فایل‌ها و کدهات رو ذخیره کنی، به نسخه‌های قبلی برگردی، و با چند نفر همزمان روی یه پروژه کار کنی بدون اینکه کارها رو خراب کنید.

=== مفاهیم پایه | Basic Concepts ===

* '''Repository (Repo)''': پوشه‌ای که Git توش تاریخچه‌ی تغییرات رو ذخیره می‌کنه.
* '''Commit''': یه "عکس لحظه‌ای" (snapshot) از وضعیت فایل‌ها در یه لحظه خاص، همراه با یه پیام توضیحی.
* '''Branch''': یه مسیر جدا برای توسعه، که بهت اجازه میده بدون تأثیر روی نسخه‌ی اصلی، تغییرات بدی.
* '''Merge''': ترکیب کردن تغییرات دو Branch با هم.
* '''Remote''': نسخه‌ای از Repo که روی یه سرور دیگه (مثل GitHub) قرار داره.
* '''Working Directory''': فایل‌های واقعی روی سیستم تو.
* '''Staging Area (Index)''': جایی که تغییرات رو قبل از Commit کردن آماده می‌کنی.

=== راه‌اندازی اولیه | Initial Setup ===

<syntaxhighlight lang="bash">
git config --global user.name "نام شما"
git config --global user.email "you@example.com"
</syntaxhighlight>

=== شروع یه پروژه | Starting a Project ===

<syntaxhighlight lang="bash">
git init                     # ساخت یه Repo جدید در پوشه فعلی
git clone <url>               # کپی کردن یه Repo از یه آدرس ریموت
</syntaxhighlight>

=== چرخه‌ی اصلی کار | Basic Workflow ===

<syntaxhighlight lang="bash">
git status                    # دیدن وضعیت فعلی فایل‌ها
git add <file>                 # اضافه کردن فایل به Staging Area
git add .                      # اضافه کردن همه فایل‌های تغییر یافته
git commit -m "پیام توضیحی"    # ثبت تغییرات
git log                        # دیدن تاریخچه Commit ها
</syntaxhighlight>

=== کار با Branch ===

<syntaxhighlight lang="bash">
git branch                     # لیست Branch ها
git branch new-feature         # ساخت Branch جدید
git checkout new-feature       # رفتن به یه Branch
git checkout -b new-feature    # ساخت و رفتن همزمان
git switch new-feature         # روش جدیدتر برای جابجایی بین Branch ها
git merge new-feature          # ادغام یه Branch با Branch فعلی
git branch -d new-feature      # حذف یه Branch
</syntaxhighlight>

=== کار با Remote (مثل GitHub) ===

<syntaxhighlight lang="bash">
git remote add origin <url>     # اضافه کردن یه ریموت
git push origin main            # ارسال تغییرات به ریموت
git pull origin main            # دریافت و ادغام تغییرات از ریموت
git fetch                       # فقط دریافت تغییرات بدون ادغام
</syntaxhighlight>

=== برگشت به عقب و اصلاح اشتباهات ===

<syntaxhighlight lang="bash">
git checkout -- <file>          # لغو تغییرات یه فایل (قبل از add)
git reset <file>                # خارج کردن فایل از Staging Area
git reset --hard HEAD~1         # حذف کامل آخرین Commit (با احتیاط!)
git revert <commit-hash>        # ساخت یه Commit جدید که تغییرات یه Commit قبلی رو خنثی می‌کنه
</syntaxhighlight>

=== فایل .gitignore ===

فایلی که بهش می‌گی Git کدوم فایل‌ها/پوشه‌ها رو نادیده بگیره (مثل node_modules، فایل‌های موقت، تنظیمات شخصی).

<syntaxhighlight lang="text">
node_modules/
.env
*.log
</syntaxhighlight>

=== اصطلاحات پرکاربرد دیگر ===

* '''HEAD''': اشاره‌گر به Commit یا Branch فعلی.
* '''Stash''': ذخیره‌ی موقت تغییرات ناتموم بدون Commit کردن (<code>git stash</code> و <code>git stash pop</code>).
* '''Conflict''': وقتی دو Branch تغییرات متناقض دارن و Git نمی‌تونه خودکار Merge کنه.
* '''Fork''': کپی کردن یه Repo کامل به اکانت خودت روی GitHub (نه دستور Git، بلکه یه قابلیت پلتفرم).
* '''Pull Request (PR)''': درخواست برای ادغام تغییرات یه Fork/Branch به پروژه اصلی، معمولاً روی GitHub.

=== منابع بیشتر | Further Reading ===

* [https://git-scm.com/doc مستندات رسمی Git]
* [https://learngitbranching.js.org/ آموزش تعاملی Git Branching]