بروزرسانی ایندکس

استفاده

git update-index [گزینه‌ها] [فایل...]

مثال‌ها

git update-index file1.txt  # بروزرسانی ایندکس برای یک فایل خاص
git update-index --add file1.txt  # اضافه کردن فایل جدید به ایندکس
git update-index --assume-unchanged file2.txt  # علامت‌گذاری فایل به‌عنوان بدون تغییر

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

دستور git update-index ایندکس (منطقه آماده‌سازی) را با وضعیت فعلی دایرکتوری کاری شما بروزرسانی می‌کند. این دستور برای مدیریت آماده‌سازی فایل‌ها، علامت‌گذاری فایل‌ها به‌عنوان بدون تغییر، و تغییر مجوزهای فایل در ایندکس استفاده می‌شود، بدون اینکه تغییراتی در دایرکتوری کاری ایجاد کند.

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

• بروزرسانی ایندکس برای یک فایل خاص پس از ایجاد تغییرات.
• اضافه کردن فایل‌های جدید به منطقه آماده‌سازی.
• علامت‌گذاری فایل‌ها به‌عنوان بدون تغییر برای جلوگیری از اضافه شدن به commit.
• تغییر مجوزهای فایل‌ها در ایندکس بدون تغییر فایل واقعی.

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

• از --add تنها زمانی استفاده کنید که بخواهید فایل‌های جدید را به منطقه آماده‌سازی اضافه کنید.
• اگر می‌خواهید فایل‌هایی را که موقتاً نیازی به commit ندارند، از اضافه شدن به commit جلوگیری کنید، از --assume-unchanged استفاده کنید.
• هنگام تغییر مجوزهای فایل با استفاده از --chmod دقت کنید، زیرا ممکن است این تغییرات روی سایر همکارانی که از همان مخزن استفاده می‌کنند تأثیر بگذارد.

محدودیت‌ها

• تغییراتی که با git update-index انجام می‌شود فقط در ایندکس محلی اعمال می‌شود و هیچ تأثیری بر دایرکتوری کاری ندارد.
• این دستور فایل‌های حذف‌شده را پیگیری نمی‌کند. برای مدیریت فایل‌های حذف‌شده باید از git rm استفاده کنید.
• علامت‌گذاری فایل‌ها به‌عنوان بدون تغییر با --assume-unchanged فقط برای فایل‌هایی که قبلاً به ایندکس اضافه شده‌اند، قابل‌استفاده است.

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

• فراموش کردن استفاده از --add زمانی که می‌خواهید فایل‌های جدید را به ایندکس اضافه کنید.
• استفاده نادرست از --assume-unchanged بر روی فایل‌هایی که باید به ایندکس اضافه شوند.
• تغییر مجوزهای فایل بدون در نظر گرفتن تأثیر آن بر همکاران.

نمای کلی

دستور git update-index ابزاری برای بروزرسانی ایندکس در گیت است که به شما امکان می‌دهد بدون تغییر دایرکتوری کاری، فایل‌ها را به ایندکس اضافه کنید، مجوزهای فایل‌ها را تغییر دهید یا فایل‌ها را به‌عنوان بدون تغییر علامت‌گذاری کنید. این ابزار در سناریوهای مختلف برای مدیریت فایل‌ها در مخزن گیت مفید است.

مقایسه با روش‌های دیگر