'\" t
.\"     Title: git-clean
.\"    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: Persian
.\"
.TH "GIT\-CLEAN" "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-clean \- حذف فایل‌های ردیابی‌نشده از درخت کاری
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fIgit clean\fR [\-d] [\-f] [\-i] [\-n] [\-q] [\-e <pattern>] [\-x | \-X] [\-\-] [<pathspec>\&...]
.fi
.sp
.SH "توضیحات (DESCRIPTION)"
.sp
درخت کاری را با حذف بازگشتی فایل‌هایی که تحت کنترل نسخه نیستند، با شروع از دایرکتوری جاری، پاکسازی می‌کند\&.
.sp
به‌طور معمول، فقط فایل‌های ناشناخته برای گیت حذف می‌شوند، اما اگر گزینه
\fB\-x\fR
مشخص شده باشد، فایل‌های نادیده‌گرفته‌شده (ignored) نیز حذف خواهند شد\&. این قابلیت برای نمونه می‌تواند جهت حذف تمام محصولات بیلد (build products) مفید باشد\&.
.sp
در صورتی که هرگونه آرگومان اختیاری
\fI<pathspec>\fR\&.\&.\&.
ارائه شود، تنها مسیرهایی که با pathspec مطابقت دارند تحت تأثیر قرار می‌گیرند\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\-d
.RS 4
به‌طور معمول، هنگامی که هیچ <pathspec> مشخص نشده باشد، git clean برای جلوگیری از حذف بیش از حد، وارد دایرکتوری‌های ردیابی‌نشده نمی‌شود\&. برای ورود بازگشتی به چنین دایرکتوری‌هایی نیز گزینه
\-d
را مشخص کنید\&. در صورتی که یک <pathspec> مشخص شده باشد،
\-d
بی‌اثر است؛ تمام فایل‌های ردیابی‌نشده‌ای که با مسیرهای مشخص‌شده مطابقت دارند (به استثنای مخازن گیت تودرتو که ذیل
\fB\-\-force\fR
ذکر شده‌اند) حذف خواهند شد\&.
.RE
.PP
\-f, \-\-force
.RS 4
اگر متغیر پیکربندی گیت clean\&.requireForce روی false تنظیم نشده باشد،
\fIgit clean\fR
از حذف فایل‌ها یا دایرکتوری‌ها امتناع می‌کند مگر اینکه
\-f
به آن داده شود\&. گیت همچنین از دستکاری مخازن گیت تودرتوی ردیابی‌نشده (دایرکتوری‌های دارای زیردایرکتوری \&.git) خودداری می‌کند، مگر اینکه یک
\-f
دوم نیز داده شود\&.
.RE
.PP
\-i, \-\-interactive
.RS 4
کارهایی را که انجام خواهد شد نشان می‌دهد و فایل‌ها را به‌صورت تعاملی پاکسازی می‌کند\&. برای جزئیات به بخش «حالت تعاملی» مراجعه کنید\&. متغیر پیکربندی
\fBclean\&.requireForce\fR
نادیده گرفته می‌شود، زیرا این حالت با تعاملی بودن، حفاظت ایمنی مختص به خود را فراهم می‌آورد\&.
.RE
.PP
\-n, \-\-dry\-run
.RS 4
در واقع چیزی را حذف نمی‌کند، فقط نشان می‌دهد چه کارهایی انجام خواهد شد\&. متغیر پیکربندی
\fBclean\&.requireForce\fR
نادیده گرفته می‌شود، زیرا در هر صورت چیزی حذف نخواهد شد\&.
.RE
.PP
\-q, \-\-quiet
.RS 4
بدون خروجی اضافی کار می‌کند؛ تنها خطاها را گزارش می‌دهد و فایل‌هایی را که با موفقیت حذف شده‌اند گزارش نمی‌کند\&.
.RE
.PP
\-e <pattern>, \-\-exclude=<pattern>
.RS 4
از الگوی استثنای (exclude) داده‌شده علاوه‌بر قوانین نادیده‌گیری استاندارد استفاده می‌کند (ببینید:
\fBgitignore\fR(5))\&.
.RE
.PP
\-x
.RS 4
از قوانین نادیده‌گیری استاندارد استفاده نمی‌کند (ببینید:
\fBgitignore\fR(5))،
اما همچنان از قوانین نادیده‌گیری ارائه‌شده با گزینه‌های
\fB\-e\fR
از خط فرمان استفاده می‌کند\&. این امکان را فراهم می‌سازد تا تمام فایل‌های ردیابی‌نشده، از جمله محصولات بیلد، حذف شوند\&. این کار می‌تواند (احتمالاً در ترکیب با
\fIgit restore\fR
یا
\fIgit reset\fR)
برای ایجاد یک دایرکتوری کاری کاملاً تمیز جهت آزمایش یک بیلد تمیز به کار رود\&.
.RE
.PP
\-X
.RS 4
تنها فایل‌های نادیده‌گرفته‌شده توسط گیت را حذف می‌کند\&. این گزینه می‌تواند برای بازسازی همه‌چیز از ابتدا و در عین حال نگه داشتن فایل‌های ایجادشده به صورت دستی، مفید باشد\&.
.RE
.SH "حالت تعاملی (INTERACTIVE MODE)"
.sp
هنگامی که دستور وارد حالت تعاملی می‌شود، فایل‌ها و دایرکتوری‌هایی را که قرار است پاکسازی شوند نمایش می‌دهد و وارد حلقه دستورات تعاملی خود می‌شود\&.
.sp
حلقه دستورات فهرستی از زیردستورهای موجود را نشان داده و اعلان "What now> " را ارائه می‌دهد\&. به‌طور کلی، هنگامی که اعلان به یک علامت
\fI>\fR
تکی ختم می‌شود، شما تنها می‌توانید یکی از گزینه‌های ارائه‌شده را انتخاب کرده و کلید return (اینتر) را فشار دهید، مانند زیر:
.sp
.if n \{\
.RS 4
.\}
.nf
    *** Commands ***
        1: clean                2: filter by pattern    3: select by numbers
        4: ask each             5: quit                 6: help
    What now> 1
.fi
.if n \{\
.RE
.\}
.sp
.sp
همچنین تا زمانی که انتخاب شما یکتا و مشخص باشد، می‌توانید از
\fBc\fR
یا
\fBclean\fR
در بالا استفاده کنید\&.
.sp
حلقه اصلی دستورات دارای ۶ زیردستور است\&.
.PP
clean
.RS 4
شروع به پاکسازی فایل‌ها و دایرکتوری‌ها کرده و سپس خارج می‌شود\&.
.RE
.PP
filter by pattern
.RS 4
این زیردستور فایل‌ها و دایرکتوری‌هایی را که قرار است حذف شوند نشان می‌دهد و اعلان "Input ignore patterns>>" را صادر می‌کند\&. می‌توانید الگوهایی را که با فاصله از هم جدا شده‌اند وارد کنید تا فایل‌ها و دایرکتوری‌ها از حذف شدن مستثنی شوند\&. برای مثال "*\&.c *\&.h" فایل‌هایی را که به "\&.c" و "\&.h" ختم می‌شوند از حذف معاف می‌کند\&. هنگامی که از نتیجه فیلتر راضی شدید، کلید ENTER را (به‌صورت خالی) فشار دهید تا به منوی اصلی بازگردید\&.
.RE
.PP
select by numbers
.RS 4
این زیردستور فایل‌ها و دایرکتوری‌هایی را که قرار است حذف شوند نشان می‌دهد و اعلان "Select items to delete>>" را صادر می‌کند\&. هنگامی که اعلان مانند این به دو علامت
\fI>>\fR
ختم می‌شود، می‌توانید بیش از یک مورد را انتخاب کنید که با فاصله یا کاما از هم جدا شده‌اند\&. همچنین می‌توانید بازه‌ها را مشخص کنید\&. برای مثال "2\-5 7,9" برای انتخاب موارد ۲، ۳، ۴، ۵، ۷، ۹ از فهرست به کار می‌رود\&. اگر عدد دوم در یک بازه حذف شود، تمام موارد باقی‌مانده انتخاب می‌شوند\&. برای مثال "7\-" برای انتخاب موارد ۷، ۸، ۹ از فهرست\&. همچنین می‌توانید از
\fI*\fR
برای انتخاب همه‌چیز استفاده کنید\&. علاوه بر این، وقتی از نتیجه فیلتر راضی شدید، کلید ENTER را (به‌صورت خالی) فشار دهید تا به منوی اصلی بازگردید\&.
.RE
.PP
ask each
.RS 4
شروع به پاکسازی می‌کند و برای حذف هر مورد باید آن را تک‌به‌تک تأیید کنید\&. لطفاً توجه داشته باشید که این اقدام به اندازه دو اقدام بالا کارآمد نیست\&.
.RE
.PP
quit
.RS 4
به شما امکان می‌دهد بدون انجام هرگونه پاکسازی خارج شوید\&.
.RE
.PP
help
.RS 4
راهنمای استفاده خلاصه از git\-clean تعاملی را نشان می‌دهد\&.
.RE
.SH "پیکربندی (CONFIGURATION)"
.sp
تمام موارد زیر این خط در این بخش به‌طور گزینشی از مستندات
\fBgit-config\fR(1)
آورده شده است\&. محتوا همان چیزی است که در آنجا یافت می‌شود:
.PP
clean\&.requireForce
.RS 4
یک مقدار بولی که باعث می‌شود git\-clean از حذف فایل‌ها امتناع کند مگر اینکه
\-f
داده شود\&. پیش‌فرض true است\&.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBgitignore\fR(5)
.SH "گیت (GIT)"
.sp
بخشی از مجموعه \fBgit\fR(1)