Git 远程仓库操作：remote/push/pull/fetch/clone
Introduction
Git 的分布式特性意味着每个开发者都可以拥有完整的代码仓库副本。而远程仓库则是团队协作的核心枢纽，所有成员通过它共享和同步代码。掌握远程仓库操作是团队开发的基础技能，本文详细介绍 remote、push、pull、fetch、clone 等核心命令。
基础语法
# 克隆远程仓库
git clone <仓库URL> # 克隆整个仓库
git clone <仓库URL> <目录名> # 克隆到指定目录
git clone --depth 1 <URL> # 浅克隆，只获取最新提交
远程仓库管理
git remote -v # 查看所有远程仓库及 URL
git remote add <名称> <URL> # 添加远程仓库
git remote remove <名称> # 删除远程仓库
git remote rename <旧名> <新名> # 重命名远程仓库
git remote show <名称> # 查看远程仓库详细信息
推送代码
git push <远程名> <分支名> # 推送本地分支到远程
git push -u <远程名> <分支名> # 推送并设置上游分支
git push --force # 强制推送（慎用！）
git push --tags # 推送所有标签
拉取代码
git pull <远程名> <分支名> # 拉取并合并远程分支
git pull --rebase <远程名> <分支> # 拉取时使用变基代替合并
获取远程更新（不合并）
git fetch <远程名> # 获取所有远程分支更新
git fetch --all # 获取所有远程仓库更新
git fetch <远程名> <分支名> # 获取指定分支
远程分支操作
git checkout -b <本地分支> <远程名>/<远程分支> # 检出远程分支
git branch -u <远程名>/<分支> <本地分支> # 设置上游分支完整代码示例
# ===== Git 远程仓库操作实战 =====
1. 克隆远程仓库
git clone https://github.com/example/project.git my-project
cd my-project
2. 查看远程仓库信息
git remote -v
origin https://github.com/example/project.git (fetch)
origin https://github.com/example/project.git (push)
3. 添加新的远程仓库（假设还有 GitLab 仓库）
git remote add gitlab https://gitlab.com/example/project.git
git remote -v
origin https://github.com/example/project.git (fetch)
origin https://github.com/example/project.git (push)
gitlab https://gitlab.com/example/project.git (fetch)
gitlab https://gitlab.com/example/project.git (push)
4. 在本地创建并切换功能分支
git checkout -b feature/new-api
echo "新API功能" > api.py
git add . && git commit -m "feat: add new API module"
5. 推送本地分支到远程（首次推送需设置上游）
git push -u origin feature/new-api
输出：
Branch feature/new-api set up to track remote branch feature/new-api from origin.
6. 其他团队成员如何获取该分支
git fetch origin
git checkout -b feature/new-api origin/feature/new-api
7. 模拟远程有更新的情况：使用 fetch 查看更新
git fetch origin
查看远程有哪些新提交
git log HEAD..origin/master
8. 使用 pull 拉取远程更新
git checkout master
git pull origin master
如果有冲突，需要解决冲突后提交
9. 使用 rebase 模式 pull（保持提交历史整洁）
git pull --rebase origin master
10. 将本地分支推送到另一个远程仓库
git push gitlab feature/new-api
11. 删除远程分支
git push origin --delete feature/new-api
或在 GitHub/GitLab 界面上操作
12. 修改远程仓库 URL
git remote set-url origin https://github.com/example/new-project.git
13. 查看远程仓库详细信息
git remote show origin
输出包括：远程分支列表、同步状态、推送/拉取 URL 等
14. 浅克隆（适用于大仓库，加快克隆速度）
git clone --depth 1 https://github.com/example/huge-repo.git
15. 同步浅克隆的完整历史（需要时）
git fetch --unshallow
echo "远程仓库操作完成！"
常见问题
Q1: git pull 和 git fetch 有什么区别？
git fetch 只是从远程仓库获取最新提交到本地，但不会自动合并或修改工作区，你可以用 git diff HEAD..origin/master 查看差异后再决定是否合并。git pull 相当于 git fetch 加 git merge，会自动将远程更新合并到当前分支。如果在协作中想要先审查远程更新再合并，推荐使用 fetch。
Q2: 推送时被拒绝（non-fast-forward）怎么办？
这通常意味着远程分支有你本地没有的提交，需要先拉取远程更新：git pull --rebase origin <分支>，解决可能的冲突后再推送。绝对不要用 --force 强制推送，除非你确定远程分支可以被覆盖（如个人分支、已确认无人协作）。
Q3: 如何同时推送到多个远程仓库？
可以添加多个 remote，然后使用 git push all <分支> 一次性推送（需配置 push.default 为 multivalent）。更常见的方式是使用 GitHub/GitLab 的镜像功能自动同步。也可以在 .git/config 中配置多个 pushurl。
Q4: 每次都要输入密码，如何配置 SSH 密钥？
使用 HTTPS 协议每次需要输入用户名和密码。将远程 URL 改为 SSH 格式可以免登录：git remote set-url origin git@github.com:username/repo.git。需要提前在本地生成 SSH 密钥（ssh-keygen -t ed25519）并将公钥添加到 GitHub/GitLab 账户设置中。