'\" t
.\"     Title: git-revert
.\"    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\-REVERT" "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-revert \- برگرداندن تغییرات برخی کامیت‌های موجود
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fIgit revert\fR [\-\-[no\-]edit] [\-n] [\-m <parent\-number>] [\-s] [\-S[<keyid>]] <commit>\&...
\fIgit revert\fR (\-\-continue | \-\-skip | \-\-abort | \-\-quit)
.fi
.sp
.SH "توضیحات (DESCRIPTION)"
.sp
با دریافت یک یا چند کامیت موجود، تغییراتی را که وصله‌های مربوطه ایجاد کرده‌اند بازمی‌گرداند و چند کامیت جدید برای ثبت این بازگردانی ایجاد می‌کند\&. این کار نیازمند آن است که درخت کاری شما تمیز باشد (هیچ تغییری نسبت به کامیت HEAD وجود نداشته باشد)\&.
.sp
نکته: دستور \fIgit revert\fR برای ثبت کامیت‌های جدید جهت خنثی کردن اثر برخی کامیت‌های قبلی (اغلب فقط یک کامیت معیوب) استفاده می‌شود\&. اگر می‌خواهید تمام تغییرات کامیت‌نشده در دایرکتوری کاری خود را دور بیندازید، باید به \fBgit-reset\fR(1) و به‌ویژه گزینه \fB\-\-hard\fR مراجعه کنید\&. اگر می‌خواهید فایل‌های خاصی را همان‌طور که در کامیت دیگری بودند استخراج کنید، باید به \fBgit-restore\fR(1) و به‌ویژه گزینه \fB\-\-source\fR مراجعه کنید\&. هنگام استفاده از این جایگزین‌ها دقت کنید، زیرا هر دوی آن‌ها تغییرات کامیت‌نشده در دایرکتوری کاری شما را نادیده گرفته و حذف می‌کنند\&.
.sp
برای آشنایی با تفاوت‌های میان این سه دستور، بخش "Reset, restore and revert" را در \fBgit\fR(1) ببینید\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
<commit>\&...
.RS 4
کامیت‌هایی که باید تغییراتشان برگردانده شود\&. برای فهرست کامل‌تری از روش‌های نگارش نام کامیت‌ها، به
\fBgitrevisions\fR(7)
مراجعه کنید\&. مجموعه‌ای از کامیت‌ها را نیز می‌توان مشخص کرد، اما به‌طور پیش‌فرض هیچ پیمایشی انجام نمی‌شود؛ به
\fBgit-rev-list\fR(1)
و گزینه
\fB\-\-no\-walk\fR
آن مراجعه کنید\&.
.RE
.PP
\-e, \-\-edit
.RS 4
با این گزینه،
\fIgit revert\fR
به شما امکان می‌دهد پیام کامیت را پیش از ثبت کامیتِ بازگردانی ویرایش کنید\&. اگر دستور را از یک ترمینال اجرا کنید، این رفتار پیش‌فرض است\&.
.RE
.PP
\-m parent\-number, \-\-mainline parent\-number
.RS 4
معمولاً نمی‌توانید یک کامیت ادغام (merge) را برگردانید زیرا مشخص نیست کدام شاخه ادغام باید به عنوان خط اصلی (mainline) در نظر گرفته شود\&. این گزینه شماره والد (شروع از ۱) خط اصلی را مشخص کرده و به revert اجازه می‌دهد تا تغییرات را نسبت به والد مشخص‌شده خنثی کند\&.
.sp
برگرداندن یک کامیت ادغام اعلام می‌کند که شما هرگز تغییرات درختی واردشده توسط آن ادغام را نخواهید خواست\&. در نتیجه، ادغام‌های بعدی تنها تغییرات درختی را وارد می‌کنند که توسط کامیت‌هایی ایجاد شده‌اند که از نیاکان ادغامِ بازگردانده‌شده قبلی نیستند\&. این ممکن است چیزی باشد یا نباشد که شما می‌خواهید\&.
.sp
برای جزئیات بیشتر، راهنمای
\m[blue]\fBrevert\-a\-faulty\-merge How\-To\fR\m[]\&\s-2\u[1]\d\s+2
را ببینید\&.
.RE
.PP
\-\-no\-edit
.RS 4
با این گزینه،
\fIgit revert\fR
ویرایشگر پیام کامیت را باز نخواهد کرد\&.
.RE
.PP
\-\-cleanup=<mode>
.RS 4
این گزینه تعیین می‌کند که پیام کامیت پیش از ارسال به سازوکار کامیت، چگونه پاک‌سازی شود\&. برای جزئیات بیشتر به
\fBgit-commit\fR(1)
مراجعه کنید\&. به‌ویژه، اگر مقدار
\fI<mode>\fR
برابر با
\fBscissors\fR
باشد، در صورت بروز تعارض، خط برش (قیچی) به
\fBMERGE_MSG\fR
اضافه می‌شود\&.
.RE
.PP
\-n, \-\-no\-commit
.RS 4
معمولاً این دستور به‌طور خودکار کامیت‌هایی با پیام‌های گزارش ثبت می‌کند که نشان می‌دهند کدام کامیت‌ها برگردانده شده‌اند\&. این فلگ تغییرات لازم برای بازگرداندن کامیت‌های نام‌برده را بر روی درخت کاری و ایندکس شما اعمال می‌کند، اما کامیت‌ها را ثبت نمی‌کند\&. علاوه بر این، هنگامی که از این گزینه استفاده می‌شود، نیازی نیست ایندکس شما با کامیت HEAD مطابقت داشته باشد؛ عملیات بازگردانی نسبت به وضعیت ابتدایی ایندکس شما انجام می‌شود\&.
.sp
این گزینه هنگامی مفید است که می‌خواهید اثر بیش از یک کامیت را به‌صورت پشت سر هم بر روی ایندکس خود بازگردانید\&.
.RE
.PP
\-S[<keyid>], \-\-gpg\-sign[=<keyid>], \-\-no\-gpg\-sign
.RS 4
امضای کامیت‌ها با GPG\&. آرگومان
\fBkeyid\fR
اختیاری است و به‌طور پیش‌فرض از شناسه کامیت‌کننده استفاده می‌کند؛ در صورت مشخص شدن، باید بدون فاصله به گزینه بچسبد\&.
گزینه
\fB\-\-no\-gpg\-sign\fR
برای لغو متغیر پیکربندی
\fBcommit\&.gpgSign\fR
و همچنین گزینه پیشین
\fB\-\-gpg\-sign\fR
مفید است\&.
.RE
.PP
\-s, \-\-signoff
.RS 4
یک خط پایانی
\fBSigned\-off\-by\fR
به انتهای پیام کامیت اضافه می‌کند\&. برای اطلاعات بیشتر گزینه signoff را در
\fBgit-commit\fR(1)
ببینید\&.
.RE
.PP
\-\-strategy=<strategy>
.RS 4
استفاده از استراتژی ادغام داده‌شده\&. تنها باید یک‌بار استفاده شود\&. برای جزئیات، بخش MERGE STRATEGIES را در
\fBgit-merge\fR(1)
ببینید\&.
.RE
.PP
\-X<option>, \-\-strategy\-option=<option>
.RS 4
ارسال گزینه ویژه استراتژی ادغام به استراتژی مربوطه\&. برای جزئیات به
\fBgit-merge\fR(1)
مراجعه کنید\&.
.RE
.PP
\fB\-\-rerere\-autoupdate\fR, \fB\-\-no\-rerere\-autoupdate\fR
.RS 4
پس از آنکه سازوکار rerere از یک حل تعارض ثبت‌شده برای به‌روزرسانی فایل‌ها در درخت کاری استفاده کرد، به آن اجازه می‌دهد تا ایندکس را نیز با نتیجه حل تعارض به‌روز کند\&.
\fB\-\-no\-rerere\-autoupdate\fR
راه خوبی است برای بررسی دوباره آنچه
\fBgit-rerere\fR(1)
انجام داده و شناسایی ادغام‌های اشتباه احتمالی، پیش از ثبت نتیجه در ایندکس با دستور جداگانه
\fBgit-add\fR(1)\&.
.RE
.PP
\-\-reference
.RS 4
به جای شروع بدنه پیام لاگ با "This reverts <full\-object\-name\-of\-the\-commit\-being\-reverted>\&."، با استفاده از فرمت "\-\-pretty=reference" به کامیت ارجاع می‌دهد (مقایسه کنید با
\fBgit-log\fR(1))\&.
متغیر پیکربندی
\fBrevert\&.reference\fR
را می‌توان برای فعال‌سازی این گزینه به‌طور پیش‌فرض استفاده کرد\&.
.RE
.SH "زیردستورهای توالی‌ساز (SEQUENCER SUBCOMMANDS)"
.PP
\-\-continue
.RS 4
عملیات در حال انجام را با استفاده از اطلاعات موجود در
\fB\&.git/sequencer\fR
ادامه می‌دهد\&. می‌توان پس از حل تعارض‌ها در یک cherry\-pick یا revert ناموفق، از آن برای ادامه کار استفاده کرد\&.
.RE
.PP
\-\-skip
.RS 4
از کامیت فعلی صرف‌نظر کرده و توالی باقی‌مانده را ادامه می‌دهد\&.
.RE
.PP
\-\-quit
.RS 4
عملیات در حال انجام فعلی را فراموش می‌کند\&. می‌توان برای پاک‌سازی وضعیت توالی‌ساز (sequencer) پس از یک cherry\-pick یا revert ناموفق از آن استفاده کرد\&.
.RE
.PP
\-\-abort
.RS 4
عملیات را لغو کرده و به وضعیت پیش از شروع توالی بازمی‌گردد\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
\fBgit\fR \fBrevert\fR \fBHEAD~3\fR
.RS 4
تغییرات مشخص‌شده توسط چهارمین کامیت مانده به آخر در HEAD را برمی‌گرداند و یک کامیت جدید با تغییرات بازگردانده‌شده ایجاد می‌کند\&.
.RE
.PP
\fBgit\fR \fBrevert\fR \fB\-n\fR \fBmaster~5\fR\fB\&.\&.\fR\fBmaster~2\fR
.RS 4
تغییرات ایجادشده توسط کامیت‌های پنجمین کامیت مانده به آخر در master (شامل آن) تا سومین کامیت مانده به آخر در master (شامل آن) را برمی‌گرداند، اما هیچ کمیتی با تغییرات بازگردانده‌شده ایجاد نمی‌کند\&. بازگردانی تنها درخت کاری و ایندکس را اصلاح می‌کند\&.
.RE
.SH "بحث و بررسی (DISCUSSION)"
.sp
اگرچه git به‌طور خودکار یک پیام کامیت پایه‌ای می‌سازد، اما \fIاکیداً\fR توصیه می‌شود دلیل بازگردانی کامیت اصلی را توضیح دهید\&. علاوه بر این، بازگردانی‌های مکررِ کامیت‌های revert منجر به خطوط عنوان به طور فزاینده‌ای دست‌وپاگیر می‌شود، مانند \fIReapply "Reapply "<original\-subject>""\fR\&. لطفاً برای کوتاه‌تر و متمایزتر شدن، بازنویسی این عناوین را مد نظر قرار دهید\&.
.SH "پیکربندی (CONFIGURATION)"
.sp
تمام موارد زیر در این بخش به‌طور گزینشی از مستندات \fBgit-config\fR(1) گنجانده شده‌اند\&. محتوا همان چیزی است که در آنجا یافت می‌شود:
.PP
revert\&.reference
.RS 4
تنظیم این متغیر روی true باعث می‌شود
\fBgit\fR
\fBrevert\fR
طوری رفتار کند که گویی گزینه
\fB\-\-reference\fR
داده شده است\&.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBgit-cherry-pick\fR(1)
.SH "گیت (GIT)"
.sp
بخشی از مجموعه \fBgit\fR(1)
.SH "نکات (NOTES)"
.IP " 1." 4
راهنمای کاربردی revert-a-faulty-merge
.RS 4
\%file:///usr/share/doc/git-doc/howto/revert-a-faulty-merge.html
.RE