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

آموزش گیت - عملیات تغییرنام

برای تغییر نام فایل‌ها، پوشه‌ها یا پیوندهای نمادین (symbolic links) درون یک مخزن گیت، از دستور git mv استفاده می‌کنیم.

تغییر نام یک دایرکتوری، پیوند نمادین یا فایل:

این دستور، git mv <source> <destination>، نام یا مسیر جدیدی را که می‌خواهیم فایل، پیوند نمادین یا دایرکتوری به آنجا منتقل شود مشخص می‌کند.

git mv [-v] [-f] [-n] [-k] <source> <destination>

مقدار <source> نام فایل، پیوند نمادین یا دایرکتوری‌ای است که در حال حاضر در مخزن وجود دارد.

مثال :-

        
git mv oldfile.txt newfile.txt.

git mv src/dir1/file1.txt src/dir2/file1.txt.

اگر فقط بخواهیم یک فایل، پیوند نمادین یا دایرکتوری تکی را جابه‌جا یا تغییر نام دهیم، از این شکل استفاده کنید.

گزینه‌ها

-f

--force

  • گزینه git mv --force در گیت به ما اجازه می‌دهد دایرکتوری‌ها، پیوندهای نمادین یا فایل‌ها را جابه‌جا یا تغییر نام دهیم.

  • در صورتی که فایلی با همین نام از قبل در مقصد وجود داشته باشد، اجازه می‌دهد این عملیات انجام شود.

  • در شرایطی که نیاز به تغییر نام یا انتقال فایل‌ها یا دایرکتوری‌های موجود با نام یکسان داریم مفید است.

  • با جلوگیری از نیاز به حذف دستی فایل‌هایی که از قبل در مقصد وجود دارند، کارها را ساده‌تر می‌کند.

git mv -f old_filename new_filename

git mv --force old_filename new_filename

-k

--keep-index

  • با استفاده از گزینه -k در git mv می‌توان در عملیات جابه‌جایی و تغییر نام از بروز خطا جلوگیری کرد.

  • مشکلاتی را که زمانی رخ می‌دهند که گیت مبدأ را ردیابی نمی‌کند یا زمانی که استفاده از -f باعث بازنویسی یک فایل موجود می‌شود، برطرف می‌کند.

  • اگر وجود فایل قطعی نباشد، در خودکارسازی یا اسکریپت‌ها مفید است.

  • با جلوگیری از توقف کار به دلیل خطا، اجرای روان‌تری برای عملیات فراهم می‌کند.

git mv -k old_filename new_filename

git mv --keep-index old_filename new_filename

-n

--dry-run

  • در گیت، با استفاده از گزینه -n یا --dry-run می‌توانیم پیش‌نمایش عملکرد دستور را بدون ایجاد تغییر واقعی در مخزن ببینیم.

  • پیش از ثبت تغییرات برنامه‌ریزی‌شده، به کاربران امکان می‌دهد آن‌ها را بررسی و تأیید کنند و نسبت به اصلاحات مدنظر اطمینان یابند.

  • این ویژگی به مدیریت محتاطانه عملیات گیت کمک می‌کند و به‌عنوان یک اقدام احتیاطی در برابر تغییرات ناخواسته عمل می‌کند.

git mv -n old_filename new_filename

git mv --dry-run old_filename new_filename

-v

--verbose

  • دستورات گیت که شامل گزینه -v یا --verbose هستند، با نمایش نام فایل‌ها هنگام جابه‌جایی یا تغییر نام، شفافیت را در زمان اجرای دستور افزایش می‌دهند و بازخورد کامل و تأیید هر اقدام را ارائه می‌دهند.

  • این قابلیت با کمک به کاربران در پیگیری و اعتبارسنجی تغییرات خاص فایل‌ها، از صحت کار اطمینان حاصل می‌کند.

git mv -v old_filename new_filename

git mv --verbose old_filename new_filename

به‌طور کلی، در صورت وجود تداخل نام، از -f (force) استفاده خواهد شد. گزینه --dry-run برای بررسی نتیجه دستور پیش از اجرای آن مفید است، به‌ویژه در پروژه‌های بزرگ‌تر.

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