'\" t
.\"     Title: git-restore
.\"    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: دستورات عمومی کاربر
.\"    Source: Git 2.55.0
.\"  Language: Persian
.\"
.TH "GIT\-RESTORE" "1" "2026\-06\-29" "Git 2\&.55\&.0" "دستورات عمومی کاربر"
.\" -----------------------------------------------------------------
.\" * 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-restore \- بازیابی فایل‌های درخت کاری
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fBgit\fR \fBrestore\fR [\fI<options>\fR] [\fB\-\-source=\fR\fI<tree>\fR] [\fB\-\-staged\fR] [\fB\-\-worktree\fR] [\fB\-\-\fR] \fI<pathspec>\fR\&...
\fBgit\fR \fBrestore\fR [\fI<options>\fR] [\fB\-\-source=\fR\fI<tree>\fR] [\fB\-\-staged\fR] [\fB\-\-worktree\fR] \fB\-\-pathspec\-from\-file=\fR\fI<file>\fR [\fB\-\-pathspec\-file\-nul\fR]
\fBgit\fR \fBrestore\fR (\fB\-p\fR|\fB\-\-patch\fR) [\fI<options>\fR] [\fB\-\-source=\fR\fI<tree>\fR] [\fB\-\-staged\fR] [\fB\-\-worktree\fR] [\fB\-\-\fR] [\fI<pathspec>\fR\&...]
.fi
.sp
.SH "توضیحات (DESCRIPTION)"
.sp
مسیرهای مشخص‌شده در درخت کاری را با محتوایی از یک منبع بازیابی بازمی‌گرداند\&. اگر مسیری ردیابی شده باشد اما در منبع بازیابی وجود نداشته باشد، برای تطابق با منبع حذف خواهد شد\&.
.sp
همچنین از این دستور می‌توان برای بازیابی محتوا در ایندکس با گزینه \fB\-\-staged\fR، یا بازیابی هم‌زمان درخت کاری و ایندکس با گزینه‌های \fB\-\-staged\fR \fB\-\-worktree\fR استفاده کرد\&.
.sp
به‌طور پیش‌فرض، اگر \fB\-\-staged\fR مشخص شود، محتویات از \fBHEAD\fR بازیابی می‌شوند، در غیر این صورت از ایندکس بازیابی خواهند شد\&. برای بازیابی از یک کامیت متفاوت از \fB\-\-source\fR استفاده کنید\&.
.sp
برای آگاهی از تفاوت‌های میان این سه دستور، به بخش «Reset, restore and revert» در \fBgit\fR(1) مراجعه کنید\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-s\fR \fI<tree>\fR, \fB\-\-source=\fR\fI<tree>\fR
.RS 4
بازیابی فایل‌های درخت کاری با محتوای درخت داده‌شده\&. معمولاً درخت مبدا با نام‌گذاری یک کامیت، شاخه یا برچسب مرتبط با آن مشخص می‌شود\&.
.sp
در صورت عدم تعیین، چنانچه
\fB\-\-staged\fR
مشخص شده باشد محتویات از
\fBHEAD\fR
و در غیر این صورت از ایندکس بازیابی می‌شوند\&.
.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\-p\fR, \fB\-\-patch\fR
.RS 4
انتخاب تعاملی تکه‌ها (hunks) در تفاوت میان منبع بازیابی و محل بازیابی\&. برای یادگیری نحوه کار با حالت
\fB\-\-patch\fR،
به بخش «Interactive Mode» در
\fBgit-add\fR(1)
مراجعه کنید\&.
.RE
.PP
\fB\-U\fR\fI<n>\fR, \fB\-\-unified=\fR\fI<n>\fR
.RS 4
تولید تفاوت‌ها (diff) با
\fI<n>\fR
خط از متن پیرامون (context)\&. تعداد خطوط بستر به‌طور پیش‌فرض برابر با
\fBdiff\&.context\fR
یا ۳ در صورت تنظیم نشدن متغیر پیکربندی است\&. (گزینه
\fB\-U\fR
بدون
\fI<n>\fR
به دلیل یک تصادف تاریخی، به‌صورت بی‌صدا به عنوان مترادفی برای
\fB\-p\fR
پذیرفته می‌شود)\&.
.RE
.PP
\fB\-\-inter\-hunk\-context=\fR\fI<n>\fR
.RS 4
نمایش بستر میان تکه‌های diff تا تعداد خطوط مشخص‌شده در
\fI<number>\fR،
که بدین ترتیب تکه‌هایی را که به یکدیگر نزدیک هستند ترکیب می‌کند\&. مقدار پیش‌فرض آن
\fBdiff\&.interHunkContext\fR
یا 0 در صورت تنظیم نشدن این گزینه در پیکربندی است\&.
.RE
.PP
\fB\-W\fR, \fB\-\-worktree\fR, \fB\-S\fR, \fB\-\-staged\fR
.RS 4
محل بازیابی را مشخص می‌کند\&. اگر هیچ‌یک از گزینه‌ها مشخص نشوند، به‌طور پیش‌فرض درخت کاری بازیابی می‌شود\&. تعیین
\fB\-\-staged\fR
تنها ایندکس را بازیابی می‌کند\&. تعیین هر دو گزینه، هر دو را بازیابی خواهد کرد\&.
.RE
.PP
\fB\-q\fR, \fB\-\-quiet\fR
.RS 4
حالت ساکت؛ جلوگیری از نمایش پیام‌های بازخورد\&. بر
\fB\-\-no\-progress\fR
دلالت دارد\&.
.RE
.PP
\fB\-\-progress\fR, \fB\-\-no\-progress\fR
.RS 4
وضعیت پیشرفت به‌طور پیش‌فرض هنگامی که به یک ترمینال متصل باشد روی جریان خطای استاندارد گزارش می‌شود، مگر اینکه گزینه
\fB\-\-quiet\fR
مشخص شده باشد\&. این فلگ گزارش پیشرفت را حتی در صورت عدم اتصال به ترمینال و صرف‌نظر از
\fB\-\-quiet\fR
فعال می‌کند\&.
.RE
.PP
\fB\-\-ours\fR, \fB\-\-theirs\fR
.RS 4
هنگام بازیابی فایل‌ها در درخت کاری از ایندکس، از مرحله ۲ (\fBours\fR) یا ۳ (\fBtheirs\fR) برای مسیرهای ادغام‌نشده استفاده می‌کند\&. این گزینه را نمی‌توان هنگام دریافت مسیرها از یک tree\-ish (یعنی با گزینه
\fB\-\-source\fR)
استفاده کرد\&.
.sp
توجه داشته باشید که در طول اجرای
\fBgit\fR
\fBrebase\fR
و
\fBgit\fR
\fBpull\fR
\fB\-\-rebase\fR،
ممکن است
\fBours\fR
و
\fBtheirs\fR
جابه‌جا به نظر برسند\&. برای جزئیات به توضیح همین گزینه‌ها در
\fBgit-checkout\fR(1)
مراجعه کنید\&.
.RE
.PP
\fB\-m\fR, \fB\-\-merge\fR
.RS 4
هنگام بازیابی فایل‌ها روی درخت کاری از ایندکس، ادغام دارای تعارض را در مسیرهای ادغام‌نشده بازسازی می‌کند\&. این گزینه را نمی‌توان هنگام دریافت مسیرها از یک tree\-ish (یعنی با گزینه
\fB\-\-source\fR)
استفاده کرد\&.
.RE
.PP
\fB\-\-conflict=\fR\fI<style>\fR
.RS 4
مشابه گزینه
\fB\-\-merge\fR
در بالا است، اما نحوه نمایش تکه‌های دارای تعارض را تغییر می‌دهد و متغیر پیکربندی
\fBmerge\&.conflictStyle\fR
را بازنویسی می‌کند\&. مقادیر ممکن عبارتند از
\fBmerge\fR
(پیش‌فرض)،
\fBdiff3\fR
و
\fBzdiff3\fR\&.
.RE
.PP
\fB\-\-ignore\-unmerged\fR
.RS 4
هنگام بازیابی فایل‌ها روی درخت کاری از ایندکس، در صورت وجود ورودی‌های ادغام‌نشده و عدم تعیین هیچ‌یک از گزینه‌های
\fB\-\-ours\fR،
\fB\-\-theirs\fR،
\fB\-\-merge\fR
یا
\fB\-\-conflict\fR،
عملیات را متوقف نمی‌کند\&. مسیرهای ادغام‌نشده روی درخت کاری دست‌نخورده باقی می‌مانند\&.
.RE
.PP
\fB\-\-ignore\-skip\-worktree\-bits\fR
.RS 4
در حالت دریافت تنک (sparse checkout)، پیش‌فرض این است که تنها ورودی‌های منطبق بر
\fI<pathspec>\fR
و الگوهای تنک در
\fB$GIT_DIR/info/sparse\-checkout\fR
به‌روزرسانی شوند\&. این گزینه الگوهای تنک را نادیده گرفته و بدون قیدوشرط هر فایلی در
\fI<pathspec>\fR
را بازیابی می‌کند\&.
.RE
.PP
\fB\-\-recurse\-submodules\fR, \fB\-\-no\-recurse\-submodules\fR
.RS 4
اگر
\fI<pathspec>\fR
نام یک زیرماژول فعال باشد و محل بازیابی شامل درخت کاری باشد، زیرماژول تنها در صورتی به‌روزرسانی می‌شود که این گزینه داده شود، که در این حالت درخت کاری آن به کامیت ثبت‌شده در پروژه مادر (superproject) بازیابی می‌شود و هرگونه تغییرات محلی رونویسی خواهد شد\&. اگر از هیچ‌چیز (یا
\fB\-\-no\-recurse\-submodules\fR)
استفاده شود، درخت‌های کاری زیرماژول‌ها به‌روزرسانی نخواهند شد\&. درست همانند
\fBgit-checkout\fR(1)،
این کار مقدار
\fBHEAD\fR
زیرماژول را جدا (detach) می‌کند\&.
.RE
.PP
\fB\-\-overlay\fR, \fB\-\-no\-overlay\fR
.RS 4
در حالت هم‌پوشانی (overlay)، هرگز فایل‌ها را هنگام بازیابی حذف نمی‌کند\&. در حالت بدون هم‌پوشانی (no\-overlay)، فایل‌های ردیابی‌شده‌ای را که در
\fI<tree>\fR
مربوط به
\fB\-\-source=\fR\fI<tree>\fR
ظاهر نمی‌شوند حذف می‌کند تا آن‌ها را دقیقاً با
\fI<tree>\fR
مطابقت دهد\&. حالت پیش‌فرض، حالت no\-overlay است\&.
.RE
.PP
\fB\-\-pathspec\-from\-file=\fR\fI<file>\fR
.RS 4
الگوی مسیر (pathspec) به جای آرگومان‌های خط فرمان، از طریق
\fI<file>\fR
ارسال می‌شود\&. اگر
\fI<file>\fR
دقیقاً
\fB\-\fR
باشد، ورودی استاندارد استفاده می‌شود\&. عناصر pathspec با
\fILF\fR
یا
\fICR\fR/\fILF\fR
از هم جدا می‌شوند\&. عناصر pathspec را می‌توان همان‌طور که برای متغیر پیکربندی
\fBcore\&.quotePath\fR
توضیح داده شده نقل‌قول کرد (به
\fBgit-config\fR(1)
مراجعه کنید)\&. همچنین به
\fB\-\-pathspec\-file\-nul\fR
و گزینه سراسری
\fB\-\-literal\-pathspecs\fR
مراجعه کنید\&.
.RE
.PP
\fB\-\-pathspec\-file\-nul\fR
.RS 4
تنها همراه با
\fB\-\-pathspec\-from\-file\fR
معنادار است\&. عناصر pathspec با نویسه
\fINUL\fR
جدا می‌شوند و سایر نویسه‌ها به صورت تحت‌اللفظی در نظر گرفته می‌شوند (شامل خطوط جدید و علامت‌های نقل‌قول)\&.
.RE
.PP
\fB\-\-\fR
.RS 4
هیچ آرگومان دیگری را به عنوان گزینه تفسیر نکن\&.
.RE
.PP
\fI<pathspec>\fR\&.\&.\&.
.RS 4
مسیرهای تحت تأثیر عملیات را محدود می‌کند\&.
.sp
برای جزئیات بیشتر، به مدخل
\fIpathspec\fR
در
\fBgitglossary\fR(7)
مراجعه کنید\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
توالی زیر به شاخه \fBmaster\fR تغییر وضعیت می‌دهد، فایل \fBMakefile\fR را به دو بازنگری قبل بازمی‌گرداند، فایل \fBhello\&.c\fR را به اشتباه حذف می‌کند و آن را از ایندکس بازیابی می‌نماید\&.
.sp
.if n \{\
.RS 4
.\}
.nf
$ git switch master
$ git restore \-\-source master~2 Makefile  \fB(1)\fR
$ rm \-f hello\&.c
$ git restore hello\&.c                     \fB(2)\fR
.fi
.if n \{\
.RE
.\}
.sp
.TS
tab(:);
r lw(\n(.lu*75u/100u).
\fB1.\fR\h'-2n':T{
استخراج یک فایل از کامیتی دیگر
T}
\fB2.\fR\h'-2n':T{
بازیابی
\fBhello\&.c\fR
از ایندکس
T}
.TE
.sp
اگر بخواهید \fIتمام\fR فایل‌های سورس C را برای مطابقت با نسخه موجود در ایندکس بازیابی کنید، می‌توانید بنویسید:
.sp
.if n \{\
.RS 4
.\}
.nf
$ git restore \*(Aq*\&.c\*(Aq
.fi
.if n \{\
.RE
.\}
.sp
.sp
به علامت‌های نقل‌قول در اطراف \fB*\&.c\fR توجه کنید\&. فایل \fBhello\&.c\fR نیز بازیابی خواهد شد، حتی اگر دیگر در درخت کاری وجود نداشته باشد، زیرا تطبیق الگو (globbing) برای تطبیق با ورودی‌های ایندکس استفاده می‌شود (نه در درخت کاری توسط شل)\&.
.sp
برای بازیابی تمام فایل‌های دایرکتوری فعلی:
.sp
.if n \{\
.RS 4
.\}
.nf
$ git restore \&.
.fi
.if n \{\
.RE
.\}
.sp
.sp
یا برای بازیابی تمام فایل‌های درخت کاری با جادوی \fItop\fR در pathspec (به \fBgitglossary\fR(7) مراجعه کنید):
.sp
.if n \{\
.RS 4
.\}
.nf
$ git restore :/
.fi
.if n \{\
.RE
.\}
.sp
.sp
برای بازیابی یک فایل در ایندکس به گونه‌ای که با نسخه موجود در \fBHEAD\fR مطابقت پیدا کند (این معادل استفاده از \fBgit-reset\fR(1) است):
.sp
.if n \{\
.RS 4
.\}
.nf
$ git restore \-\-staged hello\&.c
.fi
.if n \{\
.RE
.\}
.sp
.sp
یا می‌توانید هم ایندکس و هم درخت کاری را بازیابی کنید (این معادل استفاده از \fBgit-checkout\fR(1) است):
.sp
.if n \{\
.RS 4
.\}
.nf
$ git restore \-\-source=HEAD \-\-staged \-\-worktree hello\&.c
.fi
.if n \{\
.RE
.\}
.sp
.sp
یا فرم کوتاه آن که کاربردی‌تر ولی کمتر خواناست:
.sp
.if n \{\
.RS 4
.\}
.nf
$ git restore \-s@ \-SW hello\&.c
.fi
.if n \{\
.RE
.\}
.sp
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBgit-checkout\fR(1), \fBgit-reset\fR(1)
.SH "گیت (GIT)"
.sp
بخشی از مجموعه \fBgit\fR(1)