Git篇（三）：吃透远程协作：SSH 密钥、分支、标签全流程实战指南

前言在团队开发中Git 本地提交只是代码管理的基础真正实现多人协同、代码云端存储、版本同步分发全靠Git 远程操作。很多新手刚上手就卡在 SSH 克隆失败、推拉代码冲突、标签分支同步混乱、忽略文件配置失效等问题上。本篇整合 Git 远程全套核心实操从SSH 协议密钥配置、仓库克隆与远程关联到.gitignore忽略规则、命令别名简化操作再到标签版本管理、多分支拉取推送、远程分支清理冲突解决把课堂笔记里零散的命令梳理成一套可直接落地的完整工作流不管是个人托管代码还是团队多人协作看完就能直接上手。一、远程仓库两种传输协议HTTPS 与 SSHGit 连接远程仓库分为HTTPS、SSH 两大协议二者核心差异在于鉴权方式HTTPS 协议克隆地址以https://开头每次推拉代码都需要输入账号密码 / 个人令牌适合临时使用、不方便配置密钥的场景。SSH 协议推荐长期开发使用依靠公钥加密、私钥登录实现免密操作配置完成后永久不用重复输账号密码核心限制本地无对应 SSH 密钥完全无法通过 SSH 地址克隆仓库。1 SSH 密钥完整配置流程密钥对由公钥和私钥配套组成公钥可以公开分发相当于一把公开的锁私钥只能自己妥善保管、绝不外泄是唯一能开锁的钥匙远程服务器、Git 平台保存你的公钥后会通过加密信息校验你的私钥匹配成功就能免密码完成身份验证既不用频繁输密码安全性也远高于普通密码。1.生成 RSA 密钥对打开终端执行命令邮箱替换为自己 Gitee/GitHub 注册邮箱ssh-keygen -t rsa -C 你的注册邮箱执行后一路回车默认在用户目录生成.ssh 隐藏文件夹内部包含两个文件1.id_rsa私钥本地保存严禁泄露2.id_rsa.pub公钥复制全部内容粘贴到远程仓库平台的 SSH 公钥配置页2.检查本地密钥文件ls ~/.ssh查看公钥cat ~/.ssh/id_rsa.pub3.平台配置公钥4.本地仓库推送git remote add origin 远程仓库地址查看是否绑定成功git remote -v首次推送绑定分支git push -u origin master注意首次推送直接git push 会报错5.SSH 克隆仓库git clone gitgitee.com:用户名/仓库名.git对于4 5是两种方案后序进行提交直接执行add commit push即可二、远程仓库基础操作查看、拉取、推送1 查看已关联的远程仓库# 简略查看远程仓库别名默认远程仓库别名origin git remote # 查看远程仓库详细地址区分HTTPS/SSH地址 git remote -v2.拉取远程代码fetch pullgit fetch仅拉取远程所有更新**不自动合并**本地分支适合先查看更新再手动合并git pull等价于git fetch git merge拉取远程代码并自动合并到本地当前分支3.推送本地代码到远程仓库基础推送语法git push 远程别名 本地分支:远程分支# 本地分支与远程分支同名master可省略后半段远程分支名 git push origin master # 完整写法本地master推送到远程master git push origin master:master4.拉取远程分支代码# 完整写法 git pull origin master:master # 分支同名简写 git pull origin master三、.gitignore 忽略文件过滤垃圾文件强制保留指定文件项目中编译产物、日志、本地配置文件不需要提交到远程依靠.gitignore统一管理忽略规则。1.基础忽略语法# 忽略所有.so后缀文件 *.so # 代表反向规则虽然忽略全部.so但c.so强制纳入版本管理不忽略 !c.so2.排查文件被忽略原因git check-ignore -v 文件名执行后会输出哪一条 .gitignore 规则导致文件被忽略快速排查配置错误。3.特殊场景已经写入忽略规则但想单独提交某个文件git add 文件名四、Git 命令别名简化高频输入频繁敲长命令效率低可自定义全局别名简化操作配置后全系统生效。1.给 status 配置别名 st# --global 代表全局配置不加仅当前仓库生效 git config (--global) alias.st status # 使用等价 git status git st2.删除已配置的别名git config (--global) --unset alias.st五、版本标签 Tag 管理给发布版本打标记Tag 用于给某次稳定commit绑定版本号如 v1.0、v0.9区分正式发布版本分为本地标签、远程标签两套操作。1 本地标签操作# 1. 给最新commit快速打轻量标签 git tag v1.0 # 2. 指定某次commitID打标签历史版本标记 git tag v0.9 commitID # 3. 创建带描述的附注标签推荐可写版本说明 git tag -a v1.0 -m 1.0正式发布版本 commitID # 4. 查看所有本地标签 git tag # 5. 查看指定标签详情 git show v1.0 # 6. 删除本地标签 git tag -d v1.02 标签推送到远程仓库# 推送单个指定标签到远程 git push origin v1.0 # 一次性推送本地所有标签至远程 git push origin --tags3 删除远程标签1.在远程直接删除# origin 是你的远程别名v1.0 是要删的标签名 git push origin --delete v1.0 # 简写旧语法原理推送空内容覆盖远程标签 git push origin :v1.02.本地删除再推送1.先删除本地对应标签git tag -d v1.02.推送空分支覆盖远程标签完成删除git push origin :v1.0六、多分支远程协作创建、关联、合并、清理分支企业开发普遍采用多分支模式master/main主分支存放稳定版本dev开发分支迭代新功能远程分支操作是团队协作核心。1.分支查看命令# 仅查看本地分支 git branch # 查看本地所有远程分支 git branch -a # 查看分支对应远程追踪关系 git branch -v2.本地分支关联远程分支场景远程已提前创建dev分支本地新建分支并绑定远程追踪# 方式1创建并切换dev分支自动关联远程origin/dev git checkout -b dev origin/dev # 方式2已有本地dev分支手动绑定远程追踪 git branch --set-upstream-toorigin/dev dev3.分支推送与拉取区别# 明确指定远程主分支推送不依赖本地分支追踪关系 git push origin master # 简写推送本地分支已绑定远程追踪直接git push即可 git push4.分支合并两种方案1.线上 PRPull Request在 Gitee/GitHub 网页端发起 PR将 dev 分支代码合并进 master适合严格代码审核的团队。2.本地合并快速合并# 切换到主分支 git checkout master # 把dev分支代码合并到master git merge dev # 合并完成推送至远程 git push origin master冲突处理推拉代码、分支合并出现冲突时必须先本地手动修改冲突文件重新 add、commit 后再推送远程。5.清理失效远程分支远程分支被他人删除后本地git branch -a仍会显示残留记录同步清理# 查看远程仓库完整信息 git remote show origin # 同步清理本地不存在的远程分支记录 git remote prune origin # 删除本地无用分支 git branch -d 分支名七、完整远程协作标准工作流总结配置 SSH 密钥使用 SSH 地址克隆远程仓库本地创建文件git add→git commit提交本地版本git pull拉取远程最新代码提前规避冲突git push推送本地分支 / 标签到远程仓库多分支开发新建 dev 分支关联远程开发完成本地 merge 合并到主分支版本发布给稳定 commit 打 tag 标签推送标签至远程项目迭代后定期清理本地、远程废弃分支。八、git 常用命令总结类名命令说明配置与初始化git config --global user.name 名字设置全局用户名git config --global user.email 邮箱设置全局邮箱git init初始化一个新的Git仓库git clone url克隆远程仓库到本地文件操作与暂存git add file将指定文件添加到暂存区git add .将所有修改/新增文件添加到暂存区git rm file删除文件并记录到暂存区git mv old new重命名或移动文件提交与历史查看git commit -m 描述提交暂存区内容到本地仓库git commit --amend修改最近一次提交补充或修改git log查看提交历史记录git log --oneline以简洁单行格式查看历史git status查看当前工作区和暂存区状态git diff查看工作区与暂存区的差异分支管理git branch查看本地所有分支git branch name创建新分支git checkout name切换到指定分支git checkout -b name创建并切换到新分支git switch name切换分支新版推荐git switch -c name创建并切换分支新版推荐git branch -d name删除已合并的分支git branch -D name强制删除未合并的分支合并与变基git merge branch将指定分支合并到当前分支git rebase branch将当前分支变基到指定分支git rebase --continue解决冲突后继续变基git rebase --abort中止变基操作git cherry-pick commit挑选指定提交应用到当前分支远程仓库操作git remote -v查看远程仓库地址git remote add origin url添加远程仓库git fetch从远程仓库拉取最新内容不合并git pull拉取远程内容并自动合并git push推送本地提交到远程仓库git push -u origin branch首次推送并关联远程分支撤销与恢复git checkout -- file丢弃工作区文件的修改git restore file恢复文件新版推荐git reset HEAD file将文件从暂存区撤出git reset --soft commit撤销提交保留暂存区和工作区git reset --hard commit强制回退到指定提交慎用git revert commit创建新提交来撤销指定提交安全git stash暂存当前修改git stash pop恢复暂存的修改标签管理git tag查看所有标签git tag name创建轻量标签git tag -a name -m 描述创建带注释的标签git push origin tag推送指定标签到远程git push origin --tags推送所有标签到远程git tag -d name删除本地标签结尾Git 远程操作没有复杂原理核心是理清本地仓库、远程仓库、分支、标签四者的关联关系。SSH 密钥解决免密登录分支实现多人并行开发Tag 规范版本发布ignore 过滤冗余文件把这套命令熟练使用后就能完全驾驭团队代码协同开发避开 90% 新手远程报错问题。