git clone 使用介绍

git clone 是 将远程仓库完整复制到本地。它会自动创建远程跟踪分支（如 origin/main）并建立与远程仓库的关联。

基本语法

git clone <仓库URL> [本地目录名]

核心功能详解

1. 克隆仓库到当前目录（自动使用远程仓库名作为本地目录名）

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

2. 克隆到指定目录

   git clone https://github.com/user/repo.git my-project
   

3. 克隆特定分支

   git clone -b dev https://github.com/user/repo.git  # 只克隆dev分支
   

4. 深度克隆（仅获取最近 n 次提交，节省时间/空间）

   git clone --depth 1 https://github.com/user/repo.git  # 只克隆最新提交
   

5. SSH 协议克隆（需提前配置 SSH 密钥）

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

高级用法示例

1. 克隆仓库并立即进入目录

git clone https://github.com/user/repo.git && cd repo

2. 克隆单一分支（节省带宽）

git clone --single-branch -b main https://github.com/user/repo.git

3. 克隆子目录（需 Git 2.25+）

git clone --filter=blob:none --sparse https://github.com/user/repo.git
cd repo
git sparse-checkout set src/docs  # 只检出 src/docs 目录

4. 克隆时自定义远程名称

git clone -o upstream https://github.com/user/repo.git
# 查看远程：git remote -v 会显示 upstream 而非 origin

5. 克隆时跳过 LFS 文件（节省初始下载时间）

git clone --skip-smudge https://github.com/user/repo.git

常见问题解决

1. 权限错误：

   # HTTPS 方式提示无权限
   git clone https://github.com/private-repo.git
   # 解决方案：使用 SSH 或配置凭据存储
   git config --global credential.helper store
   

2. SSL 证书错误（仅测试环境使用）：

   git -c http.sslVerify=false clone https://example.com/repo.git
   

3. 文件名过长错误（Windows）：

   git config --global core.longpaths true
   

使用场景对比

💡 提示：克隆后自动生成的 .git 目录包含完整版本历史，删除该目录即退出版本控制。