فصل 3 عملیات‌های گیت درس 5 از 16

آموزش گیت - عملیات stash

دستور git stash برای ذخیره کار بدون ثبت آن (commit) استفاده می‌شود و تغییرات موجود در دایرکتوری کاری را که هنوز آماده ثبت نیستند، به‌طور موقت ذخیره می‌کند.

این کار به ما کمک می‌کند بین فعالیت‌ها جابه‌جا شویم یا تغییرات ناتمام را فعلاً کنار بگذاریم، بدون اینکه تاریخچه کامیت‌ها را شلوغ و انباشته کنیم.

همچنین به ما اجازه می‌دهد تمام تغییراتی را که از آخرین کامیت به بعد در ایندکس و دایرکتوری کاری انجام داده‌ایم برگردانیم و دایرکتوری کاری را به وضعیت اولیه خود بازگردانیم.

ویژگی‌های برجسته

ذخیره موقت کار - هم تغییرات مرحله‌بندی‌شده (staged) و هم تغییرات مرحله‌بندی‌نشده (unstaged) را می‌توان به‌طور موقت ذخیره کرد.

چندین استش (Stash) - می‌توان چندین مجموعه از تغییرات را ذخیره کرد و به هر ترتیبی که بخواهیم دوباره اعمال کرد.

لیست استش‌ها - فهرست تمام تغییرات استش‌شده را می‌توان یک‌جا مشاهده کرد.

اعمال استش - تغییرات استش‌شده را می‌توان بعدها با گزینه‌های apply و pop اعمال کرد. دستور git stash pop استش را پس از اعمال شدن حذف می‌کند.

استش کردن تغییرات خاص - می‌توان تنها بخش انتخابی خاصی از تغییرات را استش کرد.

استش‌ها به‌طور پیش‌فرض با برچسب "WIP on branchname..." ساخته می‌شوند، اما می‌توانیم توضیحی رساتر هم به آن اضافه کنیم.

  • استش‌های قدیمی‌تر را می‌توان با نماد reflog (مثل stash@{1}، stash@{2.hours.ago} و غیره) بازیابی کرد، در حالی که جدیدترین استش در refs/stash نگه‌داری می‌شود.

  • علاوه بر این، از طریق اندیس stash@{n} نیز می‌توان به استش‌ها دسترسی داشت که در آن {n} شماره استش است.

دستورات

دستور عمومی برای استش کردن تغییرات git stash است.

git stash

push

دستور git stash push جدیدترین تغییرات را از ایندکس و دایرکتوری کاری حذف می‌کند و در یک استش جدید ذخیره می‌کند.

  • ما این امکان را داریم که یک <message> دقیق به استش اضافه کنیم تا مشخص شود داخل آن چیست.

  • حذف کردن push آرگومان‌های غیراختیاری را محدود می‌کند تا از استش شدن ناخواسته جلوگیری شود، اما امکان گرفتن یک snapshot سریع را می‌دهد.

  • دستور git stash -p امکان انتخاب تعاملی تغییرات برای استش کردن را فراهم می‌کند؛ این دستور میان‌بری برای git stash push -p است.

  • اجزای pathspec را می‌توان پس از -- قرار داد تا مشخص‌تر شود کدام فایل‌ها یا تغییرات باید استش شوند.

save

دستور git stash save منسوخ شده (deprecated) است و باید با git stash push جایگزین شود.

git stash save
  • برخلاف git stash push، تعیین فایل‌های تکی (pathspec) در git stash save پشتیبانی نمی‌شود.

  • هر ورودی بیشتری که به git stash save داده شود، به‌جای اینکه به‌عنوان pathspec در نظر گرفته شود، به هم متصل می‌شود تا پیام استش را بسازد.

list

تمام ورودی‌های استشی که در حال حاضر ذخیره شده‌اند، با اجرای git stash list نمایش داده می‌شوند.

git stash list
  • هر ورودی استش به‌ترتیب با نام stash@{n} نام‌گذاری می‌شود که در آن stash@{0} نشان‌دهنده جدیدترین استش است.

  • این دستور نام شاخه‌ای (branch) را که در زمان ساخت هر استش در حال استفاده بوده، نمایش می‌دهد.

  • هر ورودی استش یک خلاصه کوتاه از کامیتی دارد که مبنای ساخت آن بوده است.

show

تغییرات ثبت‌شده در یک ورودی استش با دستور git stash show نمایش داده می‌شوند.

git stash show
  • این دستور به‌طور پیش‌فرض خلاصه‌ای از تغییرات را نمایش می‌دهد (diffstat)، اما با <diff-options> می‌تواند تغییرات واقعی را در هر قالبی که توسط git diff پشتیبانی می‌شود نشان دهد.

  • متغیرهای پیکربندی که رفتار پیش‌فرض برای نمایش آمار و patch را کنترل می‌کنند، شامل stash.showStat و stash.showPatch هستند.

  • هنگام نمایش به‌روزرسانی‌های استش‌شده، تنظیم stash.showIncludeUntracked تعیین می‌کند که آیا --include-untracked به‌طور پیش‌فرض فعال باشد یا نه.

apply

تغییرات یک استش با دستور git stash apply روی درخت کاری (working tree) و ایندکس (ناحیه استیجینگ) فعلی اعمال می‌شوند.

git stash apply
  • برخلاف git stash pop، این دستور استش را از لیست استش‌ها حذف نمی‌کند.

  • ما می‌توانیم از هر کامیتی که شبیه یک استشِ تولیدشده توسط git stash push یا git stash create باشد استفاده کنیم، یا با دادن نام آن (stash@{n}) یک ورودی استش خاص را مشخص کنیم.

  • برای اجرای کم‌صداتر و کاهش حجم خروجی، از -q یا --quiet استفاده کنید.

branch

یک شاخه جدید به نام <branchname> از نقطه کامیتی ایجاد می‌کند که <stash> در اصل در آن ساخته شده است.

git stash branch
  • درخت کاری و ایندکس شاخه جدید را با تغییرات ذخیره‌شده به‌روزرسانی می‌کند.

  • وقتی <stash> به شکل stash@{<revision>} وارد شود، استش پس از اعمال شدن حذف می‌شود.

  • برای ایجاد سریع شاخه همراه با تغییرات استش‌شده مناسب است؛ به‌ویژه زمانی که یک git stash apply ساده به دلیل تداخل‌ها (conflicts) پیچیده می‌شود.

clear

تمام ورودی‌های موجود در استش با دستور git stash clear پاک می‌شوند.

git stash clear
  • این ورودی‌ها پس از حذف شدن در معرض پاک‌سازی نهایی (clipping/pruning) هستند و ممکن است قابل بازیابی نباشند.

drop

یک رکورد استش از فهرست ورودی‌های استش با دستور git stash drop حذف می‌شود.

git stash drop
  • برای جلوگیری از نمایش پیام‌های تایید، آن را همراه با گزینه -q یا --quiet به کار ببرید.

create

دستور git stash create یک شیء کامیت معمولی به نام ورودی استش می‌سازد و نام شیء آن را بدون ذخیره کردن در فضای نام ref برمی‌گرداند.

git stash create
  • در مقایسه با git stash push، این قابلیت کمتر استفاده می‌شود و عمدتاً برای اهداف اسکریپت‌نویسی در نظر گرفته شده است.

store

دستور git stash store با ذخیره کردن یک استشِ ساخته‌شده با git stash create (یا یک کامیت ادغامیِ رهاشده / dangling merge commit) در ref استش، reflog استش را تغییر می‌دهد.

git stash store
  • برای ساخت و ذخیره استش‌ها معمولاً دستور git stash push ترجیح داده می‌شود.

  • این دستور بیشتر برای اهداف اسکریپت‌نویسی است و مستقیماً استفاده نمی‌شود.

گزینه‌ها

دستور git stash از گزینه‌های زیر پشتیبانی می‌کند:

-a

--all

  • وقتی همراه با git stash push و git stash save استفاده شود، گزینه -a یا --all تمام تغییرات را استش می‌کند؛ از جمله فایل‌های استیج‌شده، تغییریافته و فایل‌های ردیابی‌نشده (untracked)، از جمله آن‌هایی که معمولاً نادیده گرفته می‌شوند (ignored).

  • همچنین پس از استش کردن، از git clean برای پاک‌سازی فایل‌های ردیابی‌نشده استفاده می‌کند.

-u

--include-untracked

--no-include-untracked

  • -u / --include-untracked - وقتی همراه با git stash push یا git stash save استفاده شود، تمام فایل‌های تغییریافته، استیج‌شده و ردیابی‌نشده (از جمله آن‌هایی که معمولاً نادیده گرفته می‌شوند) را استش می‌کند.

    سپس از git clean برای پاک‌سازی آن‌ها استفاده می‌شود.

    وقتی همراه با git stash show استفاده شود، فایل‌های ردیابی‌نشده را در diff ورودی استش نشان می‌دهد.

  • --no-include-untracked - برعکس -u است؛ این گزینه هنگام استفاده از دستورهای ذکرشده در بالا، از نمایش یا استش شدن فایل‌های ردیابی‌نشده در diff جلوگیری می‌کند.

--only-untracked

  • فقط فایل‌های ردیابی‌نشده موجود در ورودی استش را به‌عنوان بخشی از diff نشان می‌دهد؛ مختص دستور git stash show است.

--index

  • وقتی همراه با دستورهای git stash pop و git stash apply استفاده شود، تلاش می‌کند تغییرات را هم به ایندکس (ناحیه استیجینگ) و هم به درخت کاری دوباره اعمال کند.

-k

--keep-index

--no-keep-index

  • وقتی با git stash push یا git stash save ترکیب شود، گزینه -k / --keep-index :- فقط تغییرات مرحله‌بندی‌نشده (unstaged) را استش می‌کند و تمام تغییراتی را که از قبل در ایندکس (ناحیه استیجینگ) قرار گرفته‌اند، حفظ می‌کند.

  • برخلاف -k، گزینه --no-keep-index وقتی همراه با دستورهای بالا استفاده شود، تمام تغییرات را—از جمله آن‌هایی که هم‌اکنون در ایندکس هستند—استش می‌کند.

git stash تمام تغییرات موجود در دایرکتوری کاری را به‌طور موقت استش می‌کند. تغییرات استش‌شده را می‌توان در صورت نیاز دوباره اعمال کرد.

پیشرفت مطالعه: وضعیت خوانده‌شدن این درس فقط در همین مرورگر ذخیره می‌شود؛ بدون نیاز به حساب کاربری.