نحوه کلون کردن یک مخزن در گیت
کلون کردن یک مخزن، یک دستور اساسی گیت است که یک کپی محلی از یک مخزن راه دور روی دستگاه شما ایجاد می کند. این به شما امکان می دهد تا به صورت آفلاین روی پروژه کار کنید، تغییرات ایجاد کنید و بدون تأثیر بر منبع تا زمانی که آماده باشید، مشارکت کنید. در حالی که forking نیز یک کپی ایجاد می کند، fork یک مخزن جداگانه است که تحت حساب شما میزبانی می شود، در حالی که clone یک کپی کاری محلی است که به مخزن راه دور اصلی متصل می ماند.
این مقاله نحوه git cloneایجاد یک کپی محلی از یک مخزن، کلون کردن در یک پوشه خاص، کلون کردن یک برچسب نسخه خاص و کار با یک مخزن انشعاب یافته را توضیح می دهد.
پاسخ خلاصه
اگر از قبل با گیت آشنا هستید و به دستورات مرجع سریع برای کلون کردن مخازن راه دور نیاز دارید، این دستورات عبارتند از:
# Clone a repository into a directory of the same name
$ git clone <repository-url>
# Clone a repository into a specific custom folder
$ git clone <repository-url> <folder-name>
# Clone a specific tag or branch instead of the default
$ git clone --branch <tag-name> <repository-url>
# Create a shallow clone with only the latest commit
$ git clone --depth 1 <repository-url>کلون کردن در یک پوشه خاص #
به طور پیش فرض، git cloneیک دایرکتوری با همان نام مخزن ایجاد می کند. شما می توانید با ارائه نام دایرکتوری هدف، این را لغو کنید، که به سازماندهی فضای کاری محلی شما کمک می کند.
سینتکس دستور
git clone [OPTIONS] <repository-url> <target-directory><repository-url>: آدرس اینترنتی HTTPS یا SSH مخزن راه دور.<target-directory>: نام پوشه محلی که مخزن در آن کپی خواهد شد. اگر این پوشه وجود نداشته باشد، گیت آن را ایجاد می کند.[OPTIONS]سوئیچ های اختیاری که کلون را به طور دقیق تنظیم می کنند:--branch <name>بعد از کلون کردن، یک شاخه یا برچسب خاص را بررسی کنید.--depth <n>یک کلون کم عمق ایجاد کنید که فقط جدیدترین کامیت ها را ذخیره کند و حجم دانلود را کاهش دهد.-o <name>به جای نام پیش فرض، یک نام دلخواه به ریموت اختصاص دهیدorigin.
نمایش فرمان
- یک مخزن را در یک پوشه سفارشی کلون کنید.
<desired-folder>نام پوشه مورد نظر خود را جایگزین کنید.کنسول$ git clone https://github.com/username/project.git <desired-folder>دستور بالا مخزن را از URL مشخص شده کپی کرده و آن را در یک پوشه جدید قرار می دهد.
- یک شاخه یا تگ خاص را فوراً کلون و بررسی کنید. مقادیر خودتان را
<branch-or-tag>جایگزین کنید.<desired-folder>کنسول$ git clone --branch <branch-or-tag> https://github.com/username/project.git <desired-folder>--branch <branch-or-tag>به جای شاخه پیش فرض، دایرکتوری کاری شما را به آن شاخه یا تگ ارجاع می دهد.<desired-folder>می تواند یک مسیر مطلق یا نسبی از پوشه مقصد باشد.
- یک کلون کوچک ایجاد کنید.کنسول
$ git clone --depth 1 https://github.com/username/project.git <desired-folder>
--depth 1فقط جدیدترین کامیت قابل دسترسی از شاخه پیش فرض (یا شاخه ای که توسط مشخص شده است--branch) را دانلود می کند و در زمان و پهنای باند صرفه جویی می کند.
کلون کردن یک تگ خاص #
تگ ها در گیت، نقاط انتشار خاصی را مشخص می کنند، مانند v1.0.0. می توانید یک تگ خاص را کپی کنید تا کد دقیق یک نسخه خاص را دریافت کنید، که برای آزمایش یا استقرار یک نسخه پایدار ایده آل است.
سینتکس دستور
git clone --branch <tag-name> <repository-url>--branch <tag-name>یا-b <tag-name>: این پرچم به گیت می گوید که به جای شاخه پیش فرض مخزن، یک تگ (یا شاخه) خاص را بررسی کند.
نمایش فرمان
v1.2.0تگ را از یک مخزن کپی کنید .کنسول$ git clone --branch v1.2.0 https://github.com/username/project.gitاین دستور مخزن را کلون می کند و کامیت خاص مرتبط با
v1.2.0تگ را بررسی می کند.- به دایرکتوری بروید و وضعیت را بررسی کنید.کنسول
$ cd project $ git status
خروجی:
Not currently on any branch ...خروجی نشان می دهد که شما در هیچ شاخه ای نیستید، به این معنی که
HEADدر حالت جدا قرار دارید – مستقیماً به کامیت مرتبط با تگ اشاره می کند، نه به یک شاخه. - اگر نیاز به ایجاد تغییرات بر اساس این نسخه دارید، یک شاخه جدید از تگ ایجاد کنید.کنسول
$ git switch -c new-feature-from-v1.2.0دستور بالا یک شاخه جدید ایجاد می کند و از
HEADحالت جدا شده به آن سوئیچ می کند و به شما امکان می دهد کار خود را کامیت کنید.
کلون کردن یک Fork از گیت هاب #
فورک کردن در گیت هاب یک کپی شخصی از مخزن به شما می دهد و به شما امکان می دهد بدون تأثیر بر پروژه اصلی، آزمایش کنید. کلون کردن آن فورک، کد را به دستگاه محلی شما می آورد تا بتوانید هر زمان که آماده بودید، توسعه دهید، کامیت کنید، ارسال کنید و سپس یک درخواست pull باز کنید.
نمایش فرمان
- برای فورک کردن یک مخزن، URL مخزن را در مرورگر باز کنید و روی Fork کلیک کنید تا یک کپی در حساب GitHub شما ایجاد شود.
- مخزن انشعاب یافته خود را روی دستگاه محلی خود کلون کنید.کنسول
$ git clone https://github.com/username/forked-project.gitآدرس مخزن بالا را با آدرس مخزن فورک شده خود جایگزین کنید.
- به دایرکتوری کلون شده بروید و موارد را فهرست کنید.کنسول
$ cd forked-project $ ls
دستور بالا تمام فایل ها و پوشه های موجود در پروژه ی فورک شده را فهرست می کند.
پیکربندی ریموت ها برای همگام سازی با Upstream
برای اینکه شاخه ی خود را با آخرین تغییرات پروژه ی اصلی به روز نگه دارید، باید یک ریموت دوم با نام قراردادی پیکربندی کنید upstream.
- مخزن اصلی را به عنوان
upstreamریموت اضافه کنید.کنسول$ git remote add upstream https://github.com/org-name/ori-project.gitاین دستور اتصالی به مخزن اصلی برقرار می کند که اکنون می توانید با نام مستعار به آن مراجعه کنید
upstream. - تأیید کنید که هر دو
origin(چنگال شما) وupstreamمطابق انتظار پیکربندی شده اند.کنسول$ git remote -vخروجی:
origin https://github.com/username/project.git (fetch) origin https://github.com/username/project.git (push) upstream https://github.com/org-name/ori-project.git (fetch) upstream https://github.com/org-name/ori-project.git (push)خروجی هر دو ریموت را نشان می دهد و تأیید می کند که هر دو
origin(چنگال شما) وupstream(اصلی) پیکربندی شده اند. - برای به روزرسانی شاخه خود با تغییرات از پروژه اصلی، تغییرات را از شاخه محلی خود دریافت کنید
upstreamوmergeیا به آن منتقل کنید.rebaseکنسول$ git fetch upstream $ git rebase upstream/main
این دستورات مخزن محلی شما را با آخرین تغییرات
upstreamپروژه اصلی همگام سازی می کنند و تضمین می کنند که نسخه جدید شما از بقیه عقب نمی ماند.
نتیجه گیری #
در این مقاله، یاد گرفتید که چگونه از آن git cloneبرای ایجاد یک کپی محلی از یک مخزن استفاده کنید. اکنون می دانید که چگونه در یک دایرکتوری خاص کلون کنید، یک برچسب انتشار خاص را بررسی کنید و با پیکربندی یک upstreamریموت برای همگام سازی تغییرات، یک مخزن انشعاب یافته را مدیریت کنید. این مهارت ها برای همکاری در پروژه ها و مدیریت مؤثر نسخه های مختلف کد شما ضروری هستند. برای اطلاعات بیشتر، به مستندات رسمی Git در مورد کلونینگ مراجعه کنید.
