جابجایی و تغییر نام فایل‌ها

پیش‌نمایش دستور

            

استفاده

git mv <منبع> <مقصد>

مثال‌ها

git mv file1.txt newfile.txt     # تغییر نام یک فایل
git mv file1.txt directory/      # جابجایی فایل به دایرکتوری
git mv file1.txt file2.txt      # تغییر نام و جابجایی فایل

محدودیت‌ها

  • فایل‌هایی که تحت گیت نیستند نمی‌توانند تغییر نام دهند
  • جابجایی یا تغییر نام فایل‌ها برای کامیت آماده می‌شود

دقیقاً چه می‌کند؟

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

موارد کاربرد رایج

  • تغییر نام فایل‌ها برای اصلاح اشتباهات یا بهتر نشان دادن محتوا.
  • جابجایی فایل‌ها از یک دایرکتوری به دایرکتوری دیگر به عنوان بخشی از بازآرایی پروژه.
  • تغییر نام و جابجایی یک فایل به مکان جدید در یک مرحله.

مقایسه با دستورات دیگر گیت

ویژگی git mv git rm
هدف تغییر نام یا جابجایی یک فایل در مخزن گیت. حذف یک فایل از مخزن گیت.
اثر جابجایی یا تغییر نام فایل و آماده‌سازی تغییرات برای کامیت. آماده‌سازی حذف فایل برای کامیت.
فایل‌ها جابجایی یا تغییر نام فایل‌هایی که توسط گیت پیگیری می‌شوند. حذف فایل‌ها از ایندکس و دایرکتوری کاری گیت.

به زبان ساده

دستور git mv ابزاری است برای جابجایی یا تغییر نام سریع فایل‌ها در پروژه گیت شما. برخلاف جابجایی یا تغییر نام فایل‌ها به صورت دستی، استفاده از git mv به گیت اطلاع می‌دهد که تغییرات به‌طور فوری پیگیری شوند و برای کامیت آماده باشند.

اشتباهات رایج

  • سعی در جابجا یا تغییر نام فایل‌هایی که تحت گیت نیستند (مثل فایل‌های بدون پیگیری).
  • فراموش کردن کامیت کردن تغییرات پس از استفاده از git mv که باعث می‌شود تغییرات در زمان ارسال به ریموت نادیده گرفته شوند.
  • استفاده از -f (اجباری) زمانی که نیازی به آن نیست، که می‌تواند منجر به بازنویسی فایل‌های موجود بدون هشدار شود.

بهترین شیوه‌ها

  • برای تمامی وظایف تغییر نام یا جابجایی فایل، از git mv استفاده کنید تا اطمینان حاصل کنید که گیت تغییرات را به درستی پیگیری کند.
  • قبل از استفاده از گزینه -f، حتماً بررسی کنید که مقصد فایل موجود است تا از بازنویسی تصادفی جلوگیری کنید.
  • همیشه پس از استفاده از git mv تغییرات را کامیت کنید تا مطمئن شوید که در تاریخچه پروژه شما ذخیره می‌شوند.

محدودیت‌ها

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

نحوه استفاده

برای جابجایی یا تغییر نام یک فایل با گیت، از دستور

git mv <منبع> <مقصد>
استفاده کنید. اگر مقصد قبلاً وجود دارد، می‌توانید از گزینه -f برای اجباری کردن جابجایی استفاده کنید. برای مشاهده پیش‌نمایش تغییرات قبل از اعمال آن‌ها، از -n برای شبیه‌سازی استفاده کنید.

نمای کلی

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

گزینه‌ها

  • -f : اجباری برای جابجایی حتی اگر مقصد موجود باشد.
  • -n : نمایش آنچه که اتفاق خواهد افتاد بدون انجام جابجایی واقعی.