آموزش گیت - افزودن فایل‌های جدید

یکی از بنیادی‌ترین کارهایی که در Git انجام می‌دهیم، افزودن فایل‌های جدید به مخزن (repository) است. این فرایند سرراست است اما در عین حال در هسته نحوه کار Git قرار دارد. چه در حال شروع یک پروژه جدید باشید و چه بخواهید به یک پروژه موجود فایل اضافه کنید، درک نحوه افزودن فایل‌ها در Git ضروری است. این راهنما روش‌های مختلف افزودن فایل‌های جدید را پوشش می‌دهد، دستورهای مرتبط را توضیح می‌دهد و بهترین شیوه‌ها را برجسته می‌کند.

برای درک گردش کار Git لطفاً به Git - Life Cycle مراجعه کنید.

فرایند افزودن فایل‌ها در Git معمولاً این روند را دنبال می‌کند:

  • ویرایش/تغییر فایل‌ها: فایل‌ها را در پوشه کاری (working directory) اضافه یا ویرایش کنید.

  • آماده‌سازی فایل‌ها برای ثبت (Stage): از git add استفاده کنید تا این فایل‌ها را به ناحیه آماده‌سازی (staging area) منتقل کنید.

  • ثبت فایل‌ها (Commit): از git commit استفاده کنید تا فایل‌ها را از ناحیه آماده‌سازی به مخزن منتقل کنید و یک نقطه ثبت‌شده در تاریخچه پروژه ایجاد نمایید.

افزودن فایل‌های جدید به یک مخزن Git

فرایند افزودن فایل‌های جدید به یک مخزن Git با ساخت یا تغییر فایل‌ها در پوشه کاری پروژه شما آغاز می‌شود. وقتی فایل‌ها آماده شدند، می‌توانیم آن‌ها را stage و commit کنیم.

ساخت یک فایل جدید

فرض کنیم روی یک پروژه کار می‌کنیم و نیاز داریم یک فایل جدید اضافه کنیم. یک فایل جدید در پوشه کاری بسازید.

برای مثال، یک فایل جدید به نام example.txt را با استفاده از هر ویرایشگر متنی یا محیط توسعه یکپارچه (IDE) بسازید.

محتوایی به آن اضافه کنید. برای نمونه:

This is an example file for the Tutorialspoint Git tutorial.

آماده‌سازی فایل جدید برای ثبت (Stage)

وقتی فایل ساخته و ویرایش شد، قبل از اینکه بتوان آن را در مخزن ثبت (commit) کرد، باید stage شود. مرحله staging به ما امکان می‌دهد فایل‌ها را برای commit آماده کنیم و کنترل داشته باشیم که چه تغییراتی شامل شوند.

برای stage کردن یک فایل، از دستور git add به همراه نام فایل استفاده کنید:

git add example.txt

این دستور فایل example.txt را از پوشه کاری به ناحیه staging منتقل می‌کند.

افزودن چندین فایل

می‌توان چندین فایل را تک‌به‌تک اضافه کرد:

git add file1.txt
git add file2.txt
git add file3.txt

یا می‌توانیم با استفاده از دستور زیر همه فایل‌های پوشه فعلی را اضافه کنیم:

git add .

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

به‌عنوان جایگزین، می‌توانیم از یک کاراکتر عام (wildcard) برای افزودن انواع خاصی از فایل‌ها استفاده کنیم. مثلاً برای افزودن همه فایل‌های .txt در پوشه فعلی:

git add *.txt

Stage کردن فایل‌ها در زیرپوشه‌ها

Git همچنین به ما اجازه می‌دهد فایل‌هایی را از زیرپوشه‌ها اضافه کنیم. برای مثال، اگر فایلی در مسیر src/main/file.java قرار دارد، می‌توانیم آن را با دستور زیر stage کنیم:

git add src/main/file.java

به‌همین‌ترتیب، می‌توانیم همه فایل‌های درون یک پوشه مشخص را اضافه کنیم:

git add src/

این دستور همه فایل‌ها و زیرپوشه‌های زیر `src` را stage می‌کند.

ثبت فایل‌های Stage‌شده (Commit)

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

برای commit کردن فایل‌های stage‌شده، از دستور زیر استفاده کنید:

git commit -m "Add example.txt file for tutorial"

پس از اجرای دستور commit، تغییرات stage‌شده اکنون بخشی از تاریخچه مخزن هستند.

افزودن فایل‌های جدید در Git یک کار بنیادی است که هر توسعه‌دهنده‌ای باید بر آن مسلط شود. با درک گردش کار Git یعنی ساختن، stage کردن و commit کردن فایل‌ها، می‌توانید فایل‌ها و تاریخچه پروژه خود را به‌طور مؤثر مدیریت کنید.

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