先搞懂：GitLab上传文件的两种常用方式（网页端+命令行）
GitLab上传文件就像“寄快递”——要么用“上门取件”（网页端，不用装软件），要么自己“去快递点寄”（命令行，适合经常用的人）。我先讲最适合新手的网页端上传，再讲效率更高的命令行上传，你按需选就行。
网页端上传：连小白都能一次学会的步骤
网页端上传不用装任何软件，打开浏览器就能操作，但要注意三个“别忘”，不然很容易出错：
第一步：打开你要传文件的GitLab仓库（比如“公司产品库”），先看清楚顶部的分支——默认是main或master，但如果是和别人合作的项目，一定别直接传main分支！我之前有次急着传活动海报，没选分支就提交，结果把开发的最新代码覆盖了，赶紧找运维回滚，花了1小时才搞定。所以不管多急，先点分支下拉框，选“新建分支”（比如“activity-poster-2024”），或者选已经建好的工作分支。
第二步：点仓库页面右上角的“+”号（对，就是那个小加号），弹出的菜单里选“上传文件”——别选“新建文件”，那是用来写代码的，传本地文件就选“上传文件”。
第三步：上传文件——要么把文件直接拖进“拖放文件到这里”的框里，要么点“选择文件”从电脑里挑。这里要注意：一次最多传10个文件（GitLab默认限制），如果文件太多， 打包成ZIP再传，不然要分好几次。
第四步：填提交信息——这步比你想的重要！别写“上传文件”这种没用的话，要写清楚“上传了什么”“版本号”，比如“添加2024年6月活动海报V1.0”“更新产品手册V2.1”。我之前帮同事找去年的活动文件，他的提交信息全是“上传文件”，翻了20页才找到，差点没疯——所以提交信息一定要“精准”！
第五步：确认所有信息没错，点“提交更改”——等个几秒钟，页面提示“提交成功”，就说明文件传到GitLab了。
是不是很简单？我第一次教我妈用网页端传她的广场舞视频到家庭仓库，她跟着步骤走，居然一次就成功了——所以别害怕，网页端上传真的是“点几下就行”。
命令行上传：适合经常用Git的人（效率更高）
如果你每天都要传文件，或者要传很多文件，命令行比网页端快10倍——但要先配置好Git环境（比如安装Git、配置SSH密钥）。我分5步讲清楚，每步都加了“大白话解释”，保证你能看懂：
git init——这步是“初始化本地仓库”，就像你在小区门口开了个快递点，专门用来处理要寄到GitLab的文件。 git add 文件名（比如git add 2024活动海报V1.0.png），如果要传整个文件夹，就输git add .（注意末尾有个点）——这步是“把文件加到暂存区”，相当于把要寄的东西装进快递袋。 git commit -m "提交信息"（比如git commit -m "添加2024年6月活动海报V1.0"）——这步是“提交暂存区的内容”，快递单上要写清楚里面是什么，不然快递员（GitLab）不知道怎么处理。 git remote add origin 你的仓库地址（比如git remote add origin git@gitlab.com:company/product-repo.git）——这步是“把本地快递点和GitLab仓库关联起来”，相当于告诉快递员“我要寄到这个地址”。 git push -u origin 分支名（比如git push -u origin activity-poster-2024）——这步是“把本地文件推送到GitLab”，相当于快递员把你的东西送到仓库了。 这里要注意两个坑：① 如果是第一次用命令行连GitLab，要先配置SSH密钥（参考GitLab官方文档：https://docs.gitlab.com/ee/ssh/ rel=”nofollow”）——我之前帮实习生配置时，他总忘加密钥，结果push了三次都失败，后来我让他把密钥存在电脑的“Git配置文件夹”里，每次换设备都先查一下，就再也没出问题；② 如果分支是新建的，要加-u参数（比如git push -u origin 新分支名），不然Git会提示“没有这个分支”。
别乱点：GitLab下载文件的3种场景应对（单文件/文件夹/整仓库）
上传搞定了，下载更要“对症下药”——不同场景用不同方法，不然会像我之前那样，想下载个单文件，却克隆了整个仓库，浪费半小时。
场景1：只下载一个文件（比如同事分享的文档）
很多人以为GitLab的单文件下载按钮在“文件页面右上角”，其实藏在“更多选项”里！我教你找：
我之前找这个按钮找了5分钟，后来问了开发才知道——GitLab为了界面简洁，把不常用的功能藏在“更多”里，所以别再盯着页面乱点了，直接找“…”就行！
场景2：要下载一个文件夹（比如“素材库”）
GitLab没有“直接下载文件夹”的按钮，但可以用“稀疏检出”命令，只下载你要的文件夹，不用下整个仓库——这招我帮设计下载素材时用过，比克隆整个仓库快3倍！步骤如下：
git clone no-checkout 仓库地址（比如git clone no-checkout git@gitlab.com:company/product-repo.git）——这步是“只下载仓库的目录结构，不下载具体文件”，相当于你先拿到一个空的快递箱，里面没有东西。 cd 仓库名（比如cd product-repo）。 git sparse-checkout init cone——这步是“告诉Git，我只要特定的文件夹”。 git sparse-checkout set 文件夹名（比如git sparse-checkout set 素材库）——这步是“把‘素材库’文件夹加到要下载的列表里”。 git checkout 分支名（比如git checkout main）——等一会儿，你要的文件夹就下载到本地了！ 是不是很高效？我上次帮设计下载“2024夏季素材”文件夹，仓库总大小是10G，但“素材库”只有500M，用稀疏检出只用了2分钟，比克隆整个仓库快多了！
场景3：要下载整个仓库（比如备份所有文件）
如果要下载仓库里的所有文件，直接用克隆命令就行：
git clone 仓库地址（比如git clone git@gitlab.com:company/product-repo.git）； 这里要注意：如果仓库很大（比如超过5G）， 找个网络好的地方克隆，不然可能会中途断开。我之前克隆过一个15G的仓库，用公司的千兆网用了10分钟，用家里的wifi用了40分钟——所以网络很重要！
最后：给你一张“GitLab上传下载问题对照表”（踩过的坑都帮你填了）
我把自己和同事遇到过的问题整理成表格，遇到问题直接查，不用再找客服：
| 常见问题 | 原因 | 解决办法 |
|---|---|---|
| 网页端上传提示“权限不足” | 没有仓库的“开发者”或以上权限 | 找仓库管理员添加权限（路径：仓库→设置→成员→输入你的用户名→选“开发者”角色） |
| 命令行push提示“fatal: repository not found” | 仓库地址输错，或没配置SSH密钥 |
|
| 下载单文件提示“404” | 文件路径错误，或文件已被删除 |
|
| 命令行clone很慢 | 网络不好，或仓库太大 |
|
怎么样？这些步骤是不是比你想象的简单？我当初学GitLab的时候，把每个步骤都记在笔记本上，现在早就烂熟于心了——其实GitLab的上传下载没那么难，就是“找对按钮+走对步骤”。你要是试的时候遇到问题，随时回来留言，我帮你看看——毕竟谁没在GitLab上踩过坑呢？赶紧去试试，等你给我报喜！
网页端上传文件时，为什么一定要选对分支？
因为如果是和别人合作的项目，直接传main或master分支很容易覆盖别人的代码。我之前急着传活动海报，没选分支就提交，结果把开发的最新代码覆盖了，找运维回滚花了1小时才搞定。所以不管多急，都要先点分支下拉框，选新建的工作分支（比如“activity-poster-2024”）或者已经建好的分支，避免影响主分支的代码。
想用命令行上传GitLab文件，得先做什么准备？
首先得安装Git软件，然后配置SSH密钥——这步很重要，不然命令行push会提示找不到仓库。我之前帮实习生配置时，他总忘加密钥，结果push了三次都失败，后来把密钥存在Git配置文件夹里，换设备时先查一下就没再出问题。你可以参考GitLab官方文档配置SSH密钥，确保命令行能连接到GitLab仓库。
GitLab里单文件的下载按钮在哪儿？怎么找？
很多人以为在文件页面右上角，其实藏在“更多选项”里。你打开要下载的文件页面（比如“2024活动方案.docx”），看文件右上角有个三个点的“更多”按钮（就是“…”），点一下弹出的菜单里选“Download”，就能自动下载了。我之前找这个按钮找了5分钟，还是问开发才知道的——GitLab为了界面简洁，把不常用功能藏在“更多”里。
想下载GitLab里的一个文件夹，能直接下吗？得怎么操作？
GitLab没有“直接下载文件夹”的按钮，但可以用“稀疏检出”命令只下载你要的文件夹。比如我帮设计下载素材时，用这招比克隆整个仓库快3倍：先克隆仓库的空框架（输入git clone no-checkout 仓库地址），进入仓库目录，开启稀疏检出（git sparse-checkout init cone），再选要下载的文件夹（git sparse-checkout set 素材库），最后checkout分支（git checkout main），等一会儿文件夹就下好了。
网页端上传文件时提示“权限不足”，是怎么回事？
这一般是因为你没有仓库的“开发者”或以上权限——GitLab默认只有管理员或开发者能上传文件。解决办法很简单，找仓库管理员添加权限就行，路径是仓库→设置→成员→输入你的用户名→选“开发者”角色。我之前帮运营的女生解决过这个问题，加了权限后她马上就传成功了。
