---
title: کلون کردن یک مخزن در گیت
description: یاد بگیرید که چگونه از git clone برای کپی کردن مخازن، کلون کردن تگ‌ها، تنظیم پوشه‌ها و مدیریت فورک‌ها با ریموت‌ها استفاده کنید.
url: "https://negarnovin.com/docs/how-to-clone-a-repository-in-git/"
updated: "2025-09-08"
category: تحقیق و توسعه
tags:
  - Clone کردن از GitHub
  - نحوه کلون کردن یک مخزن در گیت
---

# کلون کردن یک مخزن در گیت

# نحوه کلون کردن یک مخزن در گیت

 یاد بگیرید که چگونه از git clone برای کپی کردن مخازن، کلون کردن تگ ها، تنظیم پوشه ها و مدیریت فورک ها با ریموت ها استفاده کنید.

کلون کردن یک مخزن، یک دستور اساسی گیت است که یک کپی محلی از یک مخزن راه دور روی دستگاه شما ایجاد می کند. این به شما امکان می دهد تا به صورت آفلاین روی پروژه کار کنید، تغییرات ایجاد کنید و بدون تأثیر بر منبع تا زمانی که آماده باشید، مشارکت کنید. در حالی که 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>`: این پرچم به گیت می گوید که به جای شاخه پیش فرض مخزن، یک تگ (یا شاخه) خاص را بررسی کند.

### نمایش فرمان

1. `v1.2.0`تگ را از یک مخزن کپی کنید .  کنسول
   ```
   $ git clone --branch v1.2.0 https://github.com/username/project.git
   ```

   این دستور مخزن را کلون می کند و کامیت خاص مرتبط با `v1.2.0`تگ را بررسی می کند.
2. به دایرکتوری بروید و وضعیت را بررسی کنید.  کنسول
   ```
   $ cd project
   $ git status
   ```

   خروجی:

   ```
   Not currently on any branch
   ...
   ```

   خروجی نشان می دهد که شما در هیچ شاخه ای نیستید، به این معنی که `HEAD`در حالت جدا قرار دارید - مستقیماً به کامیت مرتبط با تگ اشاره می کند، نه به یک شاخه.
3. اگر نیاز به ایجاد تغییرات بر اساس این نسخه دارید، یک شاخه جدید از تگ ایجاد کنید.  کنسول
   ```
   $ git switch -c new-feature-from-v1.2.0
   ```

   دستور بالا یک شاخه جدید ایجاد می کند و از `HEAD`حالت جدا شده به آن سوئیچ می کند و به شما امکان می دهد کار خود را کامیت کنید.

## کلون کردن یک Fork از گیت هاب

فورک کردن در گیت هاب یک کپی شخصی از مخزن به شما می دهد و به شما امکان می دهد بدون تأثیر بر پروژه اصلی، آزمایش کنید. کلون کردن آن فورک، کد را به دستگاه محلی شما می آورد تا بتوانید هر زمان که آماده بودید، توسعه دهید، کامیت کنید، ارسال کنید و سپس یک درخواست pull باز کنید.

### نمایش فرمان

1. برای فورک کردن یک مخزن، URL مخزن را در مرورگر باز کنید و روی **Fork** کلیک کنید تا یک کپی در حساب GitHub شما ایجاد شود.
2. مخزن انشعاب یافته خود را روی دستگاه محلی خود کلون کنید.  کنسول
   ```
   $ git clone https://github.com/username/forked-project.git
   ```

   آدرس مخزن بالا را با آدرس مخزن فورک شده خود جایگزین کنید.
3. به دایرکتوری کلون شده بروید و موارد را فهرست کنید.  کنسول
   ```
   $ cd forked-project
   $ ls
   ```

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

### پیکربندی ریموت ها برای همگام سازی با Upstream

برای اینکه شاخه ی خود را با آخرین تغییرات پروژه ی اصلی به روز نگه دارید، باید یک ریموت دوم با نام قراردادی پیکربندی کنید `upstream`.

1. مخزن اصلی را به عنوان `upstream`ریموت اضافه کنید.  کنسول
   ```
   $ git remote add upstream https://github.com/org-name/ori-project.git
   ```

   این دستور اتصالی به مخزن اصلی برقرار می کند که اکنون می توانید با نام مستعار به آن مراجعه کنید `upstream`.
2. تأیید کنید که هر دو `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`(اصلی) پیکربندی شده اند.
3. برای به روزرسانی شاخه خود با تغییرات از پروژه اصلی، تغییرات را از شاخه محلی خود دریافت کنید `upstream`و `merge`یا به آن منتقل کنید.`rebase`  کنسول
   ```
   $ git fetch upstream
   $ git rebase upstream/main
   ```

   این دستورات مخزن محلی شما را با آخرین تغییرات `upstream`پروژه اصلی همگام سازی می کنند و تضمین می کنند که نسخه جدید شما از بقیه عقب نمی ماند.

## نتیجه گیری

در این مقاله، یاد گرفتید که چگونه از آن `git clone`برای ایجاد یک کپی محلی از یک مخزن استفاده کنید. اکنون می دانید که چگونه در یک دایرکتوری خاص کلون کنید، یک **برچسب انتشار** خاص را بررسی کنید و با پیکربندی یک `upstream`ریموت برای همگام سازی تغییرات، یک مخزن انشعاب یافته را مدیریت کنید. این مهارت ها برای همکاری در پروژه ها و مدیریت مؤثر نسخه های مختلف کد شما ضروری هستند. برای اطلاعات بیشتر، به مستندات رسمی [Git](https://git-scm.com/docs/git-clone) در مورد کلونینگ مراجعه کنید.

  نحوه کلون کردن یک مخزن در گیتکلون کردن در یک پوشه خاصکلون کردن یک تگ خاصخرید کلون کردن یک مخزن در گیتقیمت کلون کردن یک مخزن در گیتبهترین کلون کردن یک مخزن در گیت
