一、基础配置(第一次使用必配)
# 设置用户名、邮箱(和GitLab账号保持一致)
git config --global user.name "你的名字"
git config --global user.email "gitlab注册邮箱"
# 查看配置
git config --global --list
二、拉取仓库(2 种方式:HTTPS / SSH)
# 1)克隆远程仓库到本地(HTTPS,每次要输账号密码/token)
git clone https://gitlab.com/xxx/xxx.git
# 2)SSH方式(配置好ssh-key后免密,推荐)
git clone git@gitlab.com:xxx/xxx.git
# 指定分支克隆
git clone -b dev https://gitlab.com/xxx/xxx.git
三、本地分支操作(开发最常用)
# 查看本地分支
git branch
# 查看本地+远程所有分支
git branch -a
# 创建新分支
git branch feature/demo
# 创建并直接切换到新分支(高频!)
git checkout -b feature/demo
# 新版git推荐
git switch -c feature/demo
# 切换已有分支
git checkout dev
git switch dev
# 删除本地分支
git branch -d feature/demo
四、提交代码到本地仓库
# 查看文件状态(哪些改了、新增了)
git status
# 把所有变更加入暂存
git add .
# 指定单个文件
git add Test.java
# 提交到本地仓库,写注释
git commit -m "feat:新增提货计划报表逻辑"
五、同步远程 (GitLab)、推送代码
# 拉取远程最新代码(先拉再推,避免冲突!!必做)
git pull origin dev
# 推送本地分支到GitLab远程
git push origin feature/demo
# 第一次推送本地新分支到远程(建立关联)
git push -u origin feature/demo
六、合并、冲突处理、远程相关
# 拉取远程最新
git fetch origin
# 合并dev到当前分支
git merge dev
# 查看远程仓库地址
git remote -v
# 修改远程地址(HTTPS转SSH常用)
git remote set-url origin git@gitlab.com:xxx/xxx.git
七、日志、回滚、撤销(踩坑急救)
# 查看提交日志
git log
git log --oneline
# 撤销工作区修改(文件改坏了,恢复到上次commit版本)
git checkout -- Test.java
# 撤销暂存区(git add之后,取消add)
git reset HEAD Test.java
# 回退到某个提交(谨慎!公共分支不要强制回退)
git reset --hard 提交hash值
八、⭐ GitLab 特有场景(MR/PR、Tag、远程分支删除)
# 删除远程GitLab上的分支
git push origin --delete feature/demo
# 创建tag(版本号,用于发版)
git tag v1.0.0
# 推送tag到GitLab
git push origin v1.0.0
# 推送所有tag
git push origin --tags
九、标准开发流程(日常业务开发直接照这个走)
# 1.切到dev,拉最新
git switch dev
git pull origin dev
# 2.新建功能分支开发
git switch -c feature/demand-report
# 3.改代码、add、commit
git add .
git commit -m "feat:需求月报期初库存计算"
# 4.推送到GitLab远程
git push -u origin feature/demand-report
# 👉 然后去GitLab网页新建MR,提交给别人评审、合并到dev
十、补充:SSH 免密配置(推荐,不用每次输 token)
# 生成ssh密钥,一路回车
ssh-keygen -t ed25519 -C "gitlab邮箱"
# 然后复制 ~/.ssh/id_ed25519.pub 内容,粘贴到GitLab → Settings → SSH Keys