Remote — fetch، pull، push و tracking

Remote فقط یک نام برای آدرس مخزن روی سرور است (معمولاً origin). Tracking یعنی شاخهٔ محلی تو به کدام شاخهٔ سرور وصل است — از روی آن Git می‌گوید چند کامیت جلوتر یا عقب‌تری.

🎯 اهداف یادگیری

• origin را به‌عنوان نام مستعار URL توضیح دهی
• fetch را از pull جدا کنی
• -u و شاخهٔ بالادست را تنظیم کنی
• force-with-lease را به‌جای force خام استفاده کنی

🌐 Remote چیست؟

git remote -v
# origin  git@github.com:rezaian-dev/git-lab.git (fetch)
# origin  git@github.com:rezaian-dev/git-lab.git (push)

git remote add origin git@github.com:rezaian-dev/git-lab.git
git remote set-url origin git@github.com:rezaian-dev/git-lab.git

در VS Code: Publish Branch اگر origin نباشد، ویزارد GitHub را باز می‌کند.

📡 fetch ≠ pull

git fetch origin
git log --oneline HEAD..origin/main    # چه چیزی می‌آید؟
git merge --ff-only origin/main

شکل ۱۴ب — نوار وضعیت: ↑ ahead و ↓ behind. دکمهٔ Sync همان pull سپس push است.

📌 tracking

git switch -c feat/auth
git push -u origin HEAD          # -u = --set-upstream
git status -sb
# ## feat/auth...origin/feat/auth [ahead 1, behind 2]

• ahead = کامیت محلی که remote ندارد
• behind = کامیت remote که محلی نداری
• هر دو = واگرایی → باید merge یا rebase کنی قبل از push

🚀 push امن

git push --force-with-lease
# اگر کس دیگری push کرده باشد، رد می‌شود

--force کورکورانه تاریخچهٔ سرور را عوض می‌کند. --force-with-lease فقط اگر remote همان چیزی باشد که تو آخرین‌بار دیدی.

در VS Code هنگام Push اگر rejected شدی، Force Push را نزن مگر روی شاخهٔ شخصی.

✅ چک‌لیست فهم