'\" t
.\"     Title: git-switch
.\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 2026-06-29
.\"    Manual: Git Manual
.\"    Source: Git 2.55.0
.\"  Language: English
.\"
.TH "GIT\-SWITCH" "1" "2026\-06\-29" "Git 2\&.55\&.0" "Git Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
git-switch \- جابه‌جایی میان شاخه‌ها
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fBgit\fR \fBswitch\fR [\fI<options>\fR] [\fB\-\-no\-guess\fR] \fI<branch>\fR
\fBgit\fR \fBswitch\fR [\fI<options>\fR] \fB\-\-detach\fR [\fI<start\-point>\fR]
\fBgit\fR \fBswitch\fR [\fI<options>\fR] (\fB\-c\fR|\fB\-C\fR) \fI<new\-branch>\fR [\fI<start\-point>\fR]
\fBgit\fR \fBswitch\fR [\fI<options>\fR] \fB\-\-orphan\fR \fI<new\-branch>\fR
.fi
.sp
.SH "توضیحات (DESCRIPTION)"
.sp
جابه‌جایی به یک شاخهٔ مشخص‌شده\&. درخت کاری (working tree) و نمایه (index) به‌روزرسانی می‌شوند تا با شاخه مطابقت داشته باشند\&. تمامی کامیت‌های جدید به نوک (tip) این شاخه اضافه خواهند شد\&.
.sp
به‌صورت اختیاری می‌توان یک شاخهٔ جدید با استفاده از \fB\-c\fR یا \fB\-C\fR ایجاد کرد، یا به‌صورت خودکار از یک شاخهٔ ریموت هم‌نام ایجاد نمود (نگاه کنید به \fB\-\-guess\fR)، و یا با \fB\-\-detach\fR درخت کاری را هم‌زمان با جابه‌جایی، از هر شاخه‌ای جدا کرد\&.
.sp
جابه‌جایی شاخه‌ها نیازی به خالی و تمیز بودن نمایه و درخت کاری ندارد (یعنی عدم وجود تفاوت در مقایسه با \fBHEAD\fR)\&. با این حال، اگر این عملیات منجر به از بین رفتن تغییرات محلی شود لغو خواهد شد، مگر آنکه با \fB\-\-discard\-changes\fR یا \fB\-\-merge\fR دستور دیگری داده شده باشد\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fI<branch>\fR
.RS 4
شاخه برای جابه‌جایی به آن\&.
.RE
.PP
\fI<new\-branch>\fR
.RS 4
نام برای شاخهٔ جدید\&.
.RE
.PP
\fI<start\-point>\fR
.RS 4
نقطهٔ شروع برای شاخهٔ جدید\&. مشخص کردن یک
\fI<start\-point>\fR
به شما امکان می‌دهد تا شاخه‌ای را بر مبنای نقطه‌ای دیگر از تاریخچه، به‌جز جایی که
\fBHEAD\fR
در حال حاضر به آن اشاره دارد بسازید\&. (یا در مورد
\fB\-\-detach\fR،
امکان بررسی و جدا شدن از نقطه‌ای دیگر را فراهم می‌کند\&.)
.sp
می‌توانید از ساختار
\fB@\fR{\-\fI<N>\fR}
برای اشاره به
\fI<N>\fR\-امین
شاخه یا کامیتی که قبلاً با استفاده از عملیات
\fBgit\fR
\fBswitch\fR
یا
\fBgit\fR
\fBcheckout\fR
به آن جابه‌جا شده‌اید استفاده کنید\&. همچنین می‌توانید
\fB\-\fR
را مشخص نمایید که مترادف با
\fB@\fR{\-1}
است\&. این اغلب برای جابه‌جایی سریع میان دو شاخه، یا لغو جابه‌جایی اشتباه شاخه استفاده می‌شود\&.
.sp
به عنوان یک حالت ویژه، می‌توانید از
\fI<rev\-a>\fR\fB\&.\&.\&.\fR\fI<rev\-b>\fR
به عنوان میان‌بری برای پایهٔ ادغام (merge base) میان
\fI<rev\-a>\fR
و
\fI<rev\-b>\fR
استفاده کنید، مشروط بر اینکه دقیقاً یک پایهٔ ادغام وجود داشته باشد\&. می‌توانید حداکثر یکی از
\fI<rev\-a>\fR
و
\fI<rev\-b>\fR
را حذف کنید که در این صورت پیش‌فرض آن
\fBHEAD\fR
خواهد بود\&.
.RE
.PP
\fB\-c\fR \fI<new\-branch>\fR, \fB\-\-create\fR \fI<new\-branch>\fR
.RS 4
پیش از جابه‌جایی به شاخه، شاخهٔ جدیدی به نام
\fI<new\-branch>\fR
با شروع از
\fI<start\-point>\fR
ایجاد می‌کند\&. این از نظر تراکنشی معادل موارد زیر است:
.sp
.if n \{\
.RS 4
.\}
.nf
$ git branch <new\-branch>
$ git switch <new\-branch>
.fi
.if n \{\
.RE
.\}
.sp
بدین معنا که شاخه بازنشانی/ایجاد نمی‌شود مگر آنکه
\fBgit\fR
\fBswitch\fR
موفقیت‌آمیز باشد (برای مثال، هنگامی که شاخه در درخت کاری دیگری در حال استفاده است، نه تنها شاخهٔ فعلی یکسان می‌ماند، بلکه شاخه به نقطهٔ شروع نیز بازنشانی نمی‌شود)\&.
.RE
.PP
\fB\-C\fR \fI<new\-branch>\fR, \fB\-\-force\-create\fR \fI<new\-branch>\fR
.RS 4
مشابه
\fB\-\-create\fR
است، با این تفاوت که اگر
\fI<new\-branch>\fR
از قبل وجود داشته باشد، به
\fI<start\-point>\fR
بازنشانی خواهد شد\&. این یک میان‌بر کاربردی برای موارد زیر است:
.sp
.if n \{\
.RS 4
.\}
.nf
$ git branch \-f _<new\-branch>_
$ git switch _<new\-branch>_
.fi
.if n \{\
.RE
.\}
.sp
.RE
.PP
\fB\-d\fR, \fB\-\-detach\fR
.RS 4
جابه‌جایی به یک کامیت برای بازبینی و آزمایش‌های دورانداختنی\&. برای جزئیات به بخش "DETACHED HEAD" در
\fBgit-checkout\fR(1)
مراجعه کنید\&.
.RE
.PP
\fB\-\-guess\fR, \fB\-\-no\-guess\fR
.RS 4
اگر
\fI<branch>\fR
یافت نشود اما یک شاخهٔ ردیابی در دقیقاً یک ریموت (که آن را
\fI<remote>\fR
می‌نامیم) با نام منطبق وجود داشته باشد، معادل دستور زیر تلقی می‌شود:
.sp
.if n \{\
.RS 4
.\}
.nf
$ git switch \-c <branch> \-\-track <remote>/<branch>
.fi
.if n \{\
.RE
.\}
.sp
اگر شاخه در چند ریموت وجود داشته باشد و یکی از آن‌ها توسط متغیر پیکربندی
\fBcheckout\&.defaultRemote\fR
مشخص شده باشد، برای ابهام‌زدایی از آن استفاده خواهیم کرد؛ حتی اگر
\fI<branch>\fR
در بین تمام ریموت‌ها یکتا نباشد\&. برای نمونه آن را به
\fBcheckout\&.defaultRemote=origin\fR
تنظیم کنید تا در صورت مبهم بودن
\fI<branch>\fR
اما موجود بودن در ریموت
\fIorigin\fR،
شاخهٔ ریموت همواره از آنجا دریافت شود\&. همچنین به
\fBcheckout\&.defaultRemote\fR
در
\fBgit-config\fR(1)
نگاه کنید\&.
.sp
گزینهٔ
\fB\-\-guess\fR
رفتار پیش‌فرض است\&. از
\fB\-\-no\-guess\fR
برای غیرفعال کردن آن استفاده کنید\&.
.sp
رفتار پیش‌فرض را می‌توان از طریق متغیر پیکربندی
\fBcheckout\&.guess\fR
تنظیم کرد\&.
.RE
.PP
\fB\-f\fR, \fB\-\-force\fR
.RS 4
نام مستعاری برای
\fB\-\-discard\-changes\fR\&.
.RE
.PP
\fB\-\-discard\-changes\fR
.RS 4
حتی در صورت وجود تفاوت میان نمایه یا درخت کاری با
\fBHEAD\fR
عملیات را ادامه می‌دهد\&. هم نمایه و هم درخت کاری بازیابی می‌شوند تا با هدف جابه‌جایی مطابقت پیدا کنند\&. اگر
\fB\-\-recurse\-submodules\fR
مشخص شده باشد، محتوای زیرماژول‌ها نیز بازیابی می‌شود تا با هدف جابه‌جایی مطابقت یابد\&. این گزینه برای دور ریختن تغییرات محلی استفاده می‌شود\&.
.RE
.PP
\fB\-m\fR, \fB\-\-merge\fR
.RS 4
اگر تغییرات محلی روی یک یا چند فایل داشته باشید که بین شاخهٔ فعلی و شاخه‌ای که به آن جابه‌جا می‌شوید متفاوت باشند، دستور معمولاً برای حفظ تغییرات شما در بستر اصلی، از جابه‌جایی شاخه‌ها خودداری می‌کند\&. با این حال با این گزینه، تغییرات محلیِ دارای تداخل، به‌طور خودکار پیش از جابه‌جایی ذخیره (stash) شده و پس از آن مجدداً اعمال می‌شوند\&. اگر تغییرات محلی با تفاوت‌های میان شاخه‌ها هم‌پوشانی نداشته باشند، جابه‌جایی بدون ذخیره‌سازی انجام می‌شود\&. اگر اعمال مجدد تغییرات ذخیره‌شده منجر به تداخل شود، این مدخل در فهرست تغییرات ذخیره‌شده (stash list) باقی می‌ماند\&. پس از اتمام کار، تداخل‌ها را برطرف کرده و
\fBgit\fR
\fBstash\fR
\fBdrop\fR
را اجرا کنید، یا پیش از اجرای بعدیِ
\fBgit\fR
\fBstash\fR
\fBpop\fR
جهت اعمال مجدد تغییرات، درخت کاری را پاک کنید (برای نمونه با
\fBgit\fR
\fBreset\fR
\fB\-\-hard\fR)\&.
.RE
.PP
\fB\-\-conflict=\fR\fI<style>\fR
.RS 4
مشابه گزینهٔ
\fB\-\-merge\fR
در بالا است، اما نحوهٔ نمایش قطعات دارای تداخل (conflicting hunks) را تغییر می‌دهد و متغیر پیکربندی
\fBmerge\&.conflictStyle\fR
را لغو می‌کند\&. مقادیر ممکن عبارتند از
\fBmerge\fR
(پیش‌فرض)،
\fBdiff3\fR
و
\fBzdiff3\fR\&.
.RE
.PP
\fB\-q\fR, \fB\-\-quiet\fR
.RS 4
حالت بی‌صدا، پیام‌های بازخورد را سرکوب می‌کند\&.
.RE
.PP
\fB\-\-progress\fR, \fB\-\-no\-progress\fR
.RS 4
وضعیت پیشرفت به‌طور پیش‌فرض زمانی که به یک ترمینال متصل باشد روی جریان خطای استاندارد گزارش می‌شود، مگر اینکه
\fB\-\-quiet\fR
مشخص شده باشد\&. این فلگ گزارش پیشرفت را حتی در صورت عدم اتصال به ترمینال و صرف‌نظر از
\fB\-\-quiet\fR
فعال می‌سازد\&.
.RE
.PP
\fB\-t\fR, \fB\-\-track\fR[ (\fBdirect\fR|\fBinherit\fR)]
.RS 4
هنگام ساخت یک شاخهٔ جدید، پیکربندی بالادست ("upstream") را تنظیم می‌کند\&.
\fB\-c\fR
به‌طور ضمنی در نظر گرفته می‌شود\&. برای جزئیات به
\fB\-\-track\fR
در
\fBgit-branch\fR(1)
مراجعه کنید\&.
.sp
اگر گزینهٔ
\fB\-c\fR
داده نشود، نام شاخهٔ جدید از شاخهٔ ردیابی‌شدهٔ ریموت مشتق می‌شود؛ بدین صورت که بخش محلیِ refspec پیکربندی‌شده برای ریموت مربوطه بررسی شده و سپس بخش ابتدایی تا "*" حذف می‌شود\&. این کار به ما می‌گوید که هنگام شاخه‌بندی از
\fBorigin/hack\fR
(یا
\fBremotes/origin/hack\fR،
یا حتی
\fBrefs/remotes/origin/hack\fR)
از
\fBhack\fR
به عنوان شاخهٔ محلی استفاده کنیم\&. اگر نام داده‌شده فاقد اسلش باشد، یا حدس زدن بالا منجر به نامی خالی شود، حدس زدن لغو می‌شود\&. در چنین حالتی می‌توانید صریحاً نامی را با
\fB\-c\fR
مشخص کنید\&.
.RE
.PP
\fB\-\-no\-track\fR
.RS 4
پیکربندی بالادست ("upstream") را تنظیم نمی‌کند، حتی اگر متغیر پیکربندی
\fBbranch\&.autoSetupMerge\fR
برابر با true باشد\&.
.RE
.PP
\fB\-\-orphan\fR \fI<new\-branch>\fR
.RS 4
یک شاخهٔ متولدنشدهٔ (unborn) جدید به نام
\fI<new\-branch>\fR
می‌سازد\&. تمامی فایل‌های ردیابی‌شده حذف می‌شوند\&.
.RE
.PP
\fB\-\-ignore\-other\-worktrees\fR
.RS 4
هنگامی که ارجاع (ref) مورد نظر قبلاً توسط درخت کاری دیگری تحویل گرفته شده باشد،
\fBgit\fR
\fBswitch\fR
از جابه‌جایی امتناع می‌کند\&. این گزینه باعث می‌شود که در هر صورت آن ارجاع را تحویل بگیرد\&. به بیان دیگر، ارجاع می‌تواند توسط بیش از یک درخت کاری نگه‌داری شود\&.
.RE
.PP
\fB\-\-recurse\-submodules\fR, \fB\-\-no\-recurse\-submodules\fR
.RS 4
استفاده از
\fB\-\-recurse\-submodules\fR
محتوای تمامی زیرماژول‌های فعال را مطابق با کامیت ثبت‌شده در پروژهٔ اصلی (superproject) به‌روزرسانی می‌کند\&. اگر هیچ مقداری (یا
\fB\-\-no\-recurse\-submodules\fR)
استفاده نشود، درخت‌های کاری زیرماژول‌ها به‌روزرسانی نخواهند شد\&. درست مانند
\fBgit-submodule\fR(1)،
این کار
\fBHEAD\fR
زیرماژول‌ها را جدا (detach) خواهد کرد\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
دستور زیر به شاخهٔ "master" جابه‌جا می‌شود:
.sp
.if n \{\
.RS 4
.\}
.nf
$ git switch master
.fi
.if n \{\
.RE
.\}
.sp
.sp
پس از کار در شاخهٔ اشتباه، جابه‌جایی به شاخهٔ درست با دستور زیر انجام می‌شود:
.sp
.if n \{\
.RS 4
.\}
.nf
$ git switch mytopic
.fi
.if n \{\
.RE
.\}
.sp
.sp
با این حال، ممکن است شاخهٔ "اشتباه" شما و شاخهٔ درست "mytopic" در فایل‌هایی که به‌صورت محلی تغییر داده‌اید تفاوت داشته باشند؛ در این صورت جابه‌جایی بالا با چنین خطایی مواجه خواهد شد:
.sp
.if n \{\
.RS 4
.\}
.nf
$ git switch mytopic
error: You have local changes to \*(Aqfrotz\*(Aq; not switching branches\&.
.fi
.if n \{\
.RE
.\}
.sp
.sp
می‌توانید فلگ \fB\-m\fR را به دستور بدهید که تغییرات محلی شما را به شاخهٔ جدید منتقل خواهد کرد:
.sp
.if n \{\
.RS 4
.\}
.nf
$ git switch \-m mytopic
Applied autostash\&.
Switched to branch \*(Aqmytopic\*(Aq
The following paths have local changes:
M       frotz
.fi
.if n \{\
.RE
.\}
.sp
.sp
پس از جابه‌جایی، اصلاحات محلی دوباره اعمال می‌شوند و در فایل نمایهٔ شما ثبت \fIنمی‌شوند\fR، بنابراین \fBgit\fR \fBdiff\fR به شما نشان می‌دهد چه تغییراتی از نوک شاخهٔ جدید ایجاد کرده‌اید\&.
.sp
برای بازگشت به شاخهٔ قبلی پیش از جابه‌جایی به mytopic (یعنی شاخهٔ "master"):
.sp
.if n \{\
.RS 4
.\}
.nf
$ git switch \-
.fi
.if n \{\
.RE
.\}
.sp
.sp
می‌توانید یک شاخهٔ جدید را از هر کامیتی توسعه دهید\&. برای مثال، به "\fBHEAD~3\fR" جابه‌جا شوید و شاخهٔ "\fBfixup\fR" را بسازید:
.sp
.if n \{\
.RS 4
.\}
.nf
$ git switch \-c fixup HEAD~3
Switched to a new branch \*(Aqfixup\*(Aq
.fi
.if n \{\
.RE
.\}
.sp
.sp
اگر می‌خواهید شاخهٔ جدیدی را از یک شاخهٔ ریموت با همان نام آغاز کنید:
.sp
.if n \{\
.RS 4
.\}
.nf
$ git switch new\-topic
Branch `new\-topic` set up to track remote branch `new\-topic` from `origin`
Switched to a new branch `new\-topic`
.fi
.if n \{\
.RE
.\}
.sp
.sp
برای تحویل گرفتن کامیت \fBHEAD~3\fR جهت بررسی یا آزمایش موقت بدون ایجاد یک شاخهٔ جدید:
.sp
.if n \{\
.RS 4
.\}
.nf
$ git switch \-\-detach HEAD~3
HEAD is now at 9fc9555312 Merge branch \*(Aqcc/shared\-index\-permbits\*(Aq
.fi
.if n \{\
.RE
.\}
.sp
.sp
اگر مشخص شد آنچه انجام داده‌اید ارزش نگه‌داری دارد، همواره می‌توانید نام جدیدی برای آن ایجاد کنید (بدون نیاز به ترک شاخه):
.sp
.if n \{\
.RS 4
.\}
.nf
$ git switch \-c good\-surprises
.fi
.if n \{\
.RE
.\}
.sp
.SH "پیکربندی (CONFIGURATION)"
.sp
تمامی موارد زیر این خط در این بخش به‌طور گزینشی از مستندات \fBgit-config\fR(1) برگرفته شده‌اند\&. محتوا همان چیزی است که در آنجا یافت می‌شود:
.PP
\fBcheckout\&.defaultRemote\fR
.RS 4
هنگامی که دستور
\fBgit\fR
\fBcheckout\fR
\fI<something>\fR
یا
\fBgit\fR
\fBswitch\fR
\fI<something>\fR
را اجرا می‌کنید و تنها یک ریموت دارید، ممکن است به‌طور ضمنی به تحویل گرفتن و ردیابی مواردی مانند
\fBorigin/\fR\fI<something>\fR
برگردد\&. این ویژگی به محض اینکه بیش از یک ریموت با ارجاع
\fI<something>\fR
داشته باشید، از کار می‌افتد\&. این تنظیم امکان تعیین نام یک ریموت ترجیحی را فراهم می‌سازد که همیشه در ابهام‌زدایی برنده شود\&. کاربرد معمول آن تنظیم روی
\fBorigin\fR
است\&.
.sp
در حال حاضر این مورد توسط
\fBgit-switch\fR(1)
و
\fBgit-checkout\fR(1)
استفاده می‌شود، زمانی که
\fBgit\fR
\fBcheckout\fR
\fI<something>\fR
یا
\fBgit\fR
\fBswitch\fR
\fI<something>\fR
شاخهٔ
\fI<something>\fR
را روی ریموت دیگری تحویل بگیرد، و همچنین توسط
\fBgit-worktree\fR(1)
زمانی که
\fBgit\fR
\fBworktree\fR
\fBadd\fR
به یک شاخهٔ ریموت ارجاع می‌دهد\&. این تنظیم ممکن است در آینده برای سایر دستورات مشابه checkout یا قابلیت‌های دیگر استفاده شود\&.
.RE
.PP
\fBcheckout\&.guess\fR
.RS 4
مقدار پیش‌فرض را برای گزینهٔ
\fB\-\-guess\fR
یا
\fB\-\-no\-guess\fR
در
\fBgit\fR
\fBcheckout\fR
و
\fBgit\fR
\fBswitch\fR
ارائه می‌دهد\&. به
\fBgit-switch\fR(1)
و
\fBgit-checkout\fR(1)
نگاه کنید\&.
.RE
.PP
\fBcheckout\&.workers\fR
.RS 4
تعداد پردازش‌های موازی (کارگرها) برای به‌روزرسانی درخت کاری\&. پیش‌فرض یک است، یعنی اجرای متوالی\&. در صورت تنظیم روی مقداری کمتر از یک، گیت به اندازهٔ تعداد هسته‌های منطقی موجود کارگر به کار خواهد گرفت\&. این تنظیم و
\fBcheckout\&.thresholdForParallelism\fR
روی تمام دستوراتی که عملیات checkout را انجام می‌دهند اثر می‌گذارند؛ مانند checkout، clone، reset، sparse\-checkout و غیره\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBیادداشت (Note)\fR
.ps -1
.br
عملیات موازی checkout معمولاً عملکرد بهتری برای مخازن واقع در درایوهای SSD یا روی NFS فراهم می‌آورد\&. برای مخازن روی دیسک‌های چرخان و/یا سیستم‌هایی با تعداد هستهٔ اندک، روش پیش‌فرضِ checkout متوالی اغلب عملکرد بهتری دارد\&. اندازه و سطح فشرده‌سازی یک مخزن نیز ممکن است بر میزان کارایی نگارش موازی اثر بگذارد\&.
.sp .5v
.RE
.RE
.PP
\fBcheckout\&.thresholdForParallelism\fR
.RS 4
هنگام اجرای checkout موازی با تعداد اندکی فایل، هزینهٔ راه‌اندازی زیرپردازش‌ها و ارتباطات میان‌پردارشی ممکن است از مزایای موازی‌سازی فراتر رود\&. این تنظیم به شما اجازه می‌دهد تا حداقل تعداد فایل‌هایی را که باید برای آن‌ها checkout موازی انجام شود تعیین کنید\&. مقدار پیش‌فرض ۱۰۰ است\&.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBgit-checkout\fR(1), \fBgit-branch\fR(1)
.SH "GIT"
.sp
بخشی از مجموعهٔ \fBgit\fR(1)