使用 git clone 命令可将 github 仓库复制到本地:先安装配置 git,再获取 https 或 ssh 克隆地址,执行 clone 命令下载完整仓库,验证远程关联与分支,并支持指定分支、浅克隆或单文件下载。

如果您想将 GitHub 上的代码仓库复制到本地计算机进行开发或学习,则需要使用 Git 的 clone 命令。以下是完成该操作的具体步骤:
一、安装并配置 Git
在执行克隆操作前,需确保本地已安装 Git 并完成基础配置,否则 clone 命令无法识别或提交信息可能缺失。
1、访问 https://git-scm.com/ 下载对应操作系统的 Git 安装包并完成安装。
2、打开终端(macOS/Linux)或命令提示符/PowerShell(Windows),输入 git --version 验证是否安装成功。
3、执行以下两条命令设置全局用户名和邮箱:
git config --global user.name "YourName"
git config --global user.email "your.email@example.com"
二、获取 GitHub 仓库的克隆地址
GitHub 仓库必须提供有效的 HTTPS 或 SSH URL,clone 命令才能定位远程代码位置。HTTPS 地址无需额外密钥配置,适合新手;SSH 地址需提前配置公钥,适合高频操作。
1、登录 GitHub,进入目标仓库主页。
2、点击绿色按钮 Code,弹出下拉菜单。
3、在 HTTPS 标签页中,点击右侧复制图标,获得形如 https://github.com/username/repo-name.git 的地址。
4、如选择 SSH 方式,需先切换至 SSH 标签页,复制形如 git@github.com:username/repo-name.git 的地址,并确认本地已添加 SSH 密钥到 GitHub 账户。
三、执行 git clone 命令
克隆命令会完整下载远程仓库的历史记录、分支和标签,并在本地创建一个工作目录,同时自动初始化 .git 文件夹与远程 origin 关联。
1、在终端中切换至希望存放代码的父目录,例如:cd ~/Documents。
2、输入命令:git clone https://github.com/username/repo-name.git(替换为实际地址)。
3、等待下载完成,终端显示类似 Cloning into 'repo-name'... 及进度提示。
4、执行 ls 查看是否生成同名文件夹,进入该目录:cd repo-name。
四、验证克隆结果
确认本地仓库是否正确关联远程源、分支结构是否完整,可避免后续拉取或推送失败。
1、运行 git remote -v,输出应包含 origin 的 fetch 和 push URL。
2、运行 git branch -a,查看本地分支(如 main 或 master)及远程跟踪分支(如 remotes/origin/main)。
3、运行 git log --oneline -n 5,检查最近 5 条提交记录是否与 GitHub 仓库首页显示一致。
五、克隆指定分支或单个文件
默认 clone 会下载全部分支历史,但可通过参数减少数据量或仅获取特定内容,适用于大型仓库或轻量使用场景。
1、仅克隆某一分支(如 dev):git clone -b dev --single-branch https://github.com/username/repo-name.git。
2、进行浅层克隆(仅最新一次提交):git clone --depth 1 https://github.com/username/repo-name.git。
3、若只需单个文件,GitHub 界面不支持直接 clone 单文件,但可使用 curl 或 wget 下载原始链接(如点击文件 → Raw → 复制 URL 后执行 curl -O [URL])。










