Git Clone 完整入门指南（从 0 到团队实战）

一、什么是 git clone？

git clone 本质上做了三件事：

下载远程仓库所有代码（默认是完整历史）
自动创建本地仓库（包含 .git）
默认关联远程仓库（origin）

👉 一句话理解：把远程仓库完整复制到本地，并建立连接

二、最基础用法

bash 复制代码

git clone <仓库地址>

示例：

bash 复制代码

git clone https://github.com/vuejs/core.git

执行后会：

在当前目录生成 core 文件夹
自动 checkout 默认分支（通常是 main）

三、常见 clone 方式（必须掌握）

1️⃣ HTTPS（最通用）

bash 复制代码

git clone https://github.com/xxx/repo.git

特点：

简单，无需配置 SSH
需要输入账号/token（GitHub 已禁用密码）

👉 适合：新手 / 临时环境 / CI

2️⃣ SSH（团队推荐）

bash 复制代码

git clone git@github.com:xxx/repo.git

前提：

bash 复制代码

ssh-keygen -t ed25519 -C "your_email@example.com"

优点：

不用每次输入密码
更安全
CI/CD 友好

👉 适合：长期开发 / 团队协作

3️⃣ 指定目录名

bash 复制代码

git clone https://github.com/vuejs/core.git my-project

👉 避免默认仓库名过长或不规范

四、进阶用法（90%的人不会，但你应该会）

1️⃣ 只克隆最新代码（浅克隆）

bash 复制代码

git clone --depth=1 https://github.com/xxx/repo.git

优势：

下载速度快
节省磁盘

缺点：

没有完整历史（无法查看旧提交）

👉 适合：

CI/CD
快速启动项目

2️⃣ 只克隆指定分支

bash 复制代码

git clone -b develop https://github.com/xxx/repo.git

👉 避免拉一堆无用分支

3️⃣ 克隆但不 checkout

bash 复制代码

git clone --no-checkout https://github.com/xxx/repo.git

👉 用于：

大仓库优化
自定义 checkout 流程

4️⃣ 部分克隆（大仓库神器）

bash 复制代码

git clone --filter=blob:none https://github.com/xxx/repo.git

👉 只拉代码结构，不拉文件内容

适合：

Monorepo（非常关键）
前端大仓（node_modules 历史巨大）

五、企业级推荐 Clone 规范（重点）

在团队中，建议统一使用：

bash 复制代码

git clone --depth=1 -b main git@github.com:org/project.git

原因：

减少 clone 时间（CI/CD 提速 30%+）
限制误操作（只关注主分支）
统一规范，降低沟通成本

六、Clone 后必须做的 3 件事

1️⃣ 查看远程仓库

bash 复制代码

git remote -v

输出：

bash 复制代码

origin  git@github.com:xxx/repo.git (fetch)
origin  git@github.com:xxx/repo.git (push)

2️⃣ 查看分支

bash 复制代码

git branch -a

3️⃣ 设置用户信息（非常重要）

bash 复制代码

git config --global user.name "Your Name"
git config --global user.email "your@email.com"

七、常见问题（踩坑指南）

❌ 1. clone 很慢

解决方案：

bash 复制代码

# 使用镜像（国内常见）
git clone https://ghproxy.com/https://github.com/xxx/repo.git

或：

使用 SSH（更稳定）
配置代理

❌ 2. Permission denied (SSH)

bash 复制代码

ssh -T git@github.com

检查：

SSH key 是否添加到 GitHub
本地是否加载 key

❌ 3. 仓库太大

解决：

bash 复制代码

git clone --depth=1

或者：

bash 复制代码

git clone --filter=blob:none

八、结合前端工程的最佳实践（重点）

如果你是做 Vue / React / Monorepo：

👉 推荐组合：

bash 复制代码

git clone --depth=1 git@github.com:org/project.git
cd project
pnpm install

优化点：

clone + pnpm install 是启动瓶颈
可以结合：

bash 复制代码

pnpm fetch
pnpm install --offline

👉 CI/CD：

bash 复制代码

git clone --depth=1

配合：

Docker layer cache
pnpm cache

九、总结（给你一个判断标准）

场景	推荐命令
新手	`git clone https://...`
日常开发	`git clone git@...`
CI/CD	`git clone --depth=1`
大仓库	`--filter=blob:none`
指定分支	`-b develop`

十、一句话升级认知

git clone 不是"下载代码"，而是"建立一个可持续同步的代码关系"。