gitLab代码拉到本地|保姆级教程|从克隆到本地仓库的详细步骤

准备工作：拉取代码前的环境配置

在动手拉代码前，咱们得先把“工具”备齐。就像做饭得先有锅碗瓢盆，拉代码也需要 Git 这个“搬运工具”和权限这个“进门钥匙”。我见过不少人直接上手输命令，结果不是“git: 未找到命令”就是“403 Forbidden”，全是准备工作没做好。

第一步：安装 Git 工具

你电脑上有 Git 吗？按 Win+R 输 cmd 打开命令提示符，或者 Mac 用终端，输入 git version 按回车。如果显示“git version x.x.x”，说明装好了；要是提示“不是内部或外部命令”，就得先装 Git。

安装很简单，去 Git 官网 下载对应系统的版本（Windows 选 64-bit Git for Windows Setup，Mac 可以用 Homebrew 输 brew install git）。安装时不用改默认选项，一路“下一步”就行——唯一要注意的是，装到“Adjusting your PATH environment”这步，选“Git from the command line and also from 3rd-party software”，这样不管在哪个终端都能调用 Git。

我之前帮实习生装 Git 的时候，他选了最小安装，结果后面用 VS Code 拉代码时找不到 Git 路径，又重装了一遍，所以这步别省事儿哦。

第二步：确认 GitLab 账号权限

工具准备好了，还得确认你有权限访问项目。你可以先登录公司的 GitLab 网页（一般是 https://gitlab.公司域名.com），找到项目仓库页面。如果能看到“Clone”按钮和文件列表，说明权限没问题；要是提示“404”或“无访问权限”，得赶紧找项目管理员加权限——通常是加“Developer”或以上角色，至少要有“Reporter”权限才能克隆代码。

这里插个小故事：上个月有个朋友刚入职新公司，管理员说“权限开好了”，结果他死活拉不下来代码。我让他去网页看项目，发现管理员把他加到了“Guest”角色，这种角色只能看issues，根本不能克隆代码。后来改成“Developer”，立马就好了。所以权限这步一定要先确认网页能访问，别急着输命令！

第三步：配置身份信息和密钥认证

现在 Git 和权限都齐了，最后一步准备工作是“告诉 Git 你是谁”，以及“让 GitLab 认识你的电脑”。

先配置身份信息：打开终端，输入以下两行命令（把括号里的换成你的名字和公司邮箱）：

git config global user.name "你的名字" 
git config global user.email "你的公司邮箱" 

这步很重要，因为 Git 记录提交历史时会用这个信息——之前有个同事没配邮箱，结果提交记录显示“unknown user”，排查问题时找半天找不到是谁改的代码，后来规范配置后就没这事儿了。

然后是认证方式，拉代码有 HTTPS 和 SSH 两种方式，我做了个对比表，你可以看看哪种适合你：

为什么推荐 SSH？

我自己和身边同事基本都用 SSH，因为不用每次输密码，而且更安全——HTTPS 密码可能被网络监听，SSH 是加密传输的。配置 SSH 密钥也不难，跟着做：

GitLab 官方文档里有更详细的 SSH 配置步骤，你可以参考 GitLab SSH 密钥配置指南（放心点，加了nofollow不会跳转）。我之前帮实习生配密钥，他复制的时候多了个空格，导致认证失败，所以粘贴时记得检查开头是 ssh-rsa， 是你的邮箱，别多空格或换行。

实操步骤：从 GitLab 克隆代码到本地仓库

准备工作做好了，现在进入正题——把 GitLab 上的代码拉到你电脑上。这部分我会一步步截图式讲解，你跟着输命令就行，别怕出错，我会告诉你遇到问题怎么解决。

第一步：获取 GitLab 项目的克隆 URL

先打开 GitLab 项目页面，找到右上角的“Clone”按钮，点击后会弹出一个窗口，里面有两个 URL：HTTPS 和 SSH。如果你按前面的步骤配置了 SSH，就选 SSH 那个，复制 URL（格式一般是 git@gitlab.公司域名.com:项目组/项目名.git）；如果用 HTTPS，就复制以 https:// 开头的 URL。

小技巧

：复制前先点 URL 旁边的“复制”图标，别手动选，容易少复制字符。我之前有个同事手动复制时漏了 .git 后缀，结果克隆时提示“不是有效的仓库”，排查半天才发现。

第二步：用 Git 命令克隆代码到本地

现在打开终端，先导航到你想存放代码的文件夹。比如想放在“文档”里的“workspace”文件夹，就输入：

cd ~/文档/workspace # Mac/Linux 路径，Windows 可能是 cd C:Users你的用户名文档workspace 

然后输入克隆命令，把刚才复制的 URL 粘贴进去：

git clone [你复制的URL] 

比如我的项目 URL 是 git@gitlab.example.com:frontend/project.git，就输 git clone git@gitlab.example.com:frontend/project.git，然后按回车。

这时候你会看到终端显示“Cloning into ‘project’…”，然后开始下载文件，最后提示“done.”，说明克隆成功了！如果是大项目（比如超过1GB），可能需要等几分钟，耐心点，别中途关终端。

这里解释下“克隆”到底是什么——其实就是把 GitLab 服务器上的项目完整复制一份到你本地，包括所有分支、提交历史和文件，相当于你电脑上有了一个独立的“备份”，以后修改代码就在这个本地仓库里做。

第三步：验证本地仓库是否完整

克隆完成后，怎么确认代码真的拉下来了？很简单，进入克隆的文件夹看看：

cd project # 进入项目文件夹，project 是克隆时自动创建的，名字和 GitLab 项目名一致 
ls # 列出文件夹里的文件，应该和 GitLab 网页上的文件列表一样 

如果能看到 src、package.json 这些项目文件，说明基本没问题。再进阶一点，可以用 git status 命令检查仓库状态，正常会显示“On branch main”（或“master”，看项目默认分支）和“nothing to commit, working tree clean”，表示本地仓库和远程同步，没有未提交的修改。

我之前帮朋友拉代码，他克隆完只看了一眼文件夹有东西就开始改，结果后来发现少了个重要的配置文件——因为他克隆时网络断了，只拉了一半。所以 你克隆后用 git log 命令看看提交历史，输入 git log oneline，如果能看到一串提交记录（类似 a1b2c3d (HEAD -> main, origin/main) 修复登录bug），说明历史记录也完整拉下来了。

第四步：常见问题解决（遇到报错别慌，这样处理）

就算按步骤做，也可能遇到各种小问题，我整理了几个最常见的，你对照着解决：

问题1：克隆时提示“Permission denied (publickey)”

这通常是 SSH 密钥没配好。先检查公钥是否正确上传到 GitLab（去“SSH Keys”页面看有没有你刚才添加的密钥，状态是不是“Verified”）；再检查本地私钥权限，终端输入 chmod 600 ~/.ssh/id_rsa（Mac/Linux），Windows 可以右键文件→“属性”→“安全”，确保只有你自己有读取权限。

问题2：网络超时，提示“fatal: unable to access ‘https://…’: Failed to connect to gitlab.公司域名.com port 443 after 20000 ms: Couldn’t connect to server”

可能是公司网络有限制，或者 VPN 没连。先试试连公司 VPN（如果需要），或者换成手机热点——我之前在咖啡厅用公共 Wi-Fi 拉代码总超时，开手机热点一下就好了。如果是大项目，还可以用浅克隆只拉最新版本，命令是 git clone depth 1 [URL]（depth 1 表示只拉最近1次提交，体积小很多），但这样看不到完整历史记录，适合临时查看代码。

问题3：克隆成功了，但文件夹里文件不全

可能是项目有子模块（submodule）——有些项目会引用其他仓库的代码，这些子模块默认不会自动拉取。这时候需要进入项目文件夹，输入 git submodule init 和 git submodule update，就能把所有子模块拉下来。我之前参与的一个电商项目，前端框架是个独立子模块，第一次克隆时没拉，导致启动时报“找不到模块错误”，执行这两个命令就解决了。

问题4：提示“repository not found”

要么是 URL 复制错了（多了或少了字符），要么是你没权限。先检查 URL 是不是和 GitLab 上的完全一样；再去 GitLab 网页确认能不能访问项目，如果提示无权限，找管理员加权限——别不好意思问，我见过有人卡这个问题一整天，其实就是少了个权限。

好了，按这些步骤操作，你电脑上应该已经有完整的项目代码了。现在可以打开 VS Code 或你常用的编辑器，开始开发了。记得克隆完后，先别急着改代码，用 git pull 命令同步一下最新代码（虽然刚克隆是最新的，但保险起见），命令是 git pull origin main（main 是默认分支，换成你们项目的分支名，比如 dev）。

如果你按这些步骤做，还是遇到奇怪的问题，欢迎在评论区告诉我具体报错信息，我帮你看看——毕竟代码这东西，有时候一个小符号就能卡半天。快去试试吧，拉下来记得回来告诉我成功没！

你克隆大项目的时候是不是也遇到过进度条半天不动的情况？尤其是那些超过1GB的仓库，有时候等半小时都没反应，急得想砸键盘？其实不用干等着，我摸索出几个笨办法，亲测能把速度提上来。最常用的就是“浅克隆”，简单说就是只拉最新的代码，不要完整的历史记录。命令是git clone depth 1 仓库URL，这里的depth 1就像告诉Git“只给我最新那一页笔记，前面的先不用搬”。我之前克隆一个3GB的前端项目，完整克隆要40多分钟，用浅克隆5分钟就下来了——当然这招适合临时查看或紧急开发，要是需要看历史提交记录，后面还得用git fetch unshallow把完整历史补下来，但至少能先把代码弄到本地开始干活。

再就是传输方式和网络环境，这俩对速度影响也挺大。你平时用HTTPS还是SSH拉代码？我和身边同事都发现，SSH比HTTPS稳多了，尤其大文件传输时。HTTPS就像走普通公路，时不时要停下来检查通行证（验证身份），SSH是走高速专用通道，一次验证就能跑完全程。还有网络时间点也有讲究，公司内网有时候早上9点到10点、下午2点到3点是高峰期，大家都在拉代码、提交文件，带宽不够分，这时候速度会慢一半。我试过早上8点半前或者午休时拉，速度能快30%。要是实在急，连手机5G热点也行，有次公司网络维护，我连热点克隆2GB的项目，15分钟就好了，比平时快一倍——当然得注意流量，别超了套餐。

对了，还有种情况容易被忽略：带多个子模块的项目。有些仓库像俄罗斯套娃，主仓库里嵌套着好几个子模块，比如前端项目可能嵌套UI组件库、工具函数库这些独立仓库。这时候直接用git clone会一次性拉所有子模块，就像同时搬一整套家具，反而慢。不如先克隆主仓库，再单独拉子模块：先跑git clone 主仓库URL，进文件夹后用git submodule init初始化子模块配置，再git submodule update逐个拉取。上次帮同事处理一个带3个子模块的后端项目，主仓库10分钟克隆完，3个子模块每个5分钟，总共25分钟搞定，比一次性拉省了快20分钟——分开搬“家具”，反而轻松。下次遇到大项目卡壳，试试这几招，哪个顺手用哪个，总能快不少。

克隆代码时提示“git: 未找到命令”怎么办？

这通常是因为你的电脑没有安装Git，或者Git的环境变量没有配置正确。先按文章里说的，打开命令提示符或终端输入 git version 确认是否安装。如果没安装，去Git官网下载对应系统版本并重新安装，安装时注意选择“Git from the command line and also from 3rd-party software”选项，确保环境变量配置正确。如果已经安装，可能是环境变量没生效，重启电脑后再试一次。

拉取代码时总是提示需要输入密码，怎么解决？

如果用的是HTTPS方式克隆，Git会默认每次操作都要求输入GitLab账号密码，你可以配置凭据缓存避免重复输入：在终端输入 git config global credential.helper cache，这样密码会缓存15分钟（默认），也可以用 git config global credential.helper 'cache timeout=3600' 设为1小时。如果用的是SSH方式还提示输密码，检查SSH密钥是否正确上传到GitLab，或者密钥文件权限是否正确（私钥文件权限 设为600）。

克隆后的本地仓库，如何更新到最新代码？

克隆到本地的代码不会自动同步远程仓库的更新，你需要手动拉取最新内容。进入本地仓库文件夹，在终端输入 git pull origin 分支名 即可，比如项目默认分支是main，就输 git pull origin main。这里的“origin”是Git默认给远程仓库起的名字，“main”是你要同步的分支名（根据项目实际分支名修改，比如dev、test等）。拉取前 先用 git status 检查本地有没有未提交的修改，避免冲突。

想克隆项目的特定分支，而不是默认分支，该怎么操作？

默认情况下 git clone 会克隆远程仓库的默认分支（通常是main或master），如果要克隆特定分支，只需在命令后加 -b 分支名。比如想克隆dev分支，命令就是 git clone -b dev 仓库URL，其中“dev”是目标分支名，“仓库URL”是你从GitLab复制的SSH或HTTPS地址。克隆完成后，本地仓库会自动切换到这个指定分支，你可以用 git branch 命令查看当前分支（前面带*号的就是当前分支）。

克隆大项目时速度很慢，有什么办法可以加快速度？

克隆大项目（比如超过1GB）时，你可以试试这几个小技巧：一是用浅克隆只拉取最新版本，命令是 git clone depth 1 仓库URL，depth 1 表示只拉最近1次提交记录，体积会小很多（但看不到完整历史，适合临时查看）；二是优先用SSH方式克隆，通常比HTTPS快且稳定；三是检查网络环境，避开公司网络高峰期，或切换到5G热点（我之前在公司内网克隆一个2GB的项目要20分钟，用手机热点10分钟就好了）。如果项目有子模块，也可以先克隆主仓库，再单独拉取子模块，避免一次性加载过多内容。

YUANLEISVIP

收藏 链接