在團隊協作中,開發者通常不會直接從零開始建立一個新專案
而是從遠端儲存庫(remote repository)複製整個專案到自己的電腦。
今天我們要介紹的 git clone,是 Git 裡第一次拿到遠端專案時必備的指令。
想像一下,你要搬家,把整個專案「搬」到你的電腦上,這就是 clone 做的事。
git clone?它會把遠端儲存庫完整複製到本地,包括:
.git 目錄(Git 內部資料)換句話說,git clone 並不是「下載一份檔案」這麼簡單,而是把整個 Git 世界搬到你電腦裡。
擁有完整的開發歷史、分支架構與遠端設定,等於完整複製出一個能運作的 Git 專案。
git clone <repository-url>
這條指令會:
origin 為遠端名稱,並綁定該 URL。git clone https://github.com/octocat/Hello-World.git
執行後會出現一個 Hello-World/ 資料夾,內容包含:
Hello-World/
├── .git/ ← Git 版本資料夾
├── README.md
└── index.js
main)git clone https://github.com/octocat/Hello-World.git my-project
結果:
my-project/
├── .git/
├── README.md
└── index.js
my-project 資料夾如果你只想要某個分支,而不是整個歷史,可以加上:
git clone -b <branch-name> --single-branch <repo-url>
→ 節省時間與空間,特別適合大型專案。
git clone --depth 1 <repo-url>
→ 僅下載最新一次提交的版本,歷史會被省略。
非常適合只想「看程式碼、不需要完整歷史」的情境。
git clone git@github.com:username/project.git
需要先設定 SSH key(可回顧 Day 15)。
優點是設定一次後,推送(push)時不再需要密碼,非常適合長期協作。
| 指令 | 用途 | 時機 |
|---|---|---|
| git clone | 第一次取得整個遠端專案 | 初次進入專案 |
| git pull | 取得遠端最新更新 | 開發過程中 |
👉 一般流程是:
git clone:把遠端專案搬回家git pull:之後定期更新內容你可以把它想成:
clone 是「第一次下載整個遊戲」
pull 是「下載每日更新檔」
git clone 拉到本地git branch -a
git switch <branch-name>
git clone 是開發者進入專案的第一步
origin
git pull,完成專案同步把遠端專案搬回家後,就可以開始你與團隊的開發旅程啦!