远程仓库操作概览

远程仓库操作概览

远程仓库是Git协作开发的核心组件，允许开发者在不同位置共享代码。理解如何与远程仓库交互对团队协作至关重要，涉及克隆、推送、拉取等基本操作，以及分支管理、冲突解决等进阶技巧。

远程仓库基础配置

添加远程仓库

使用git remote add命令将本地仓库与远程仓库关联：

git remote add origin https://github.com/user/repo.git

origin是默认的远程仓库别名，可通过-v查看详细信息：

git remote -v
# 输出示例：
# origin  https://github.com/user/repo.git (fetch)
# origin  https://github.com/user/repo.git (push)

修改远程地址

当仓库迁移时需要更新URL：

git remote set-url origin https://new.url/repo.git

多远程仓库配置

项目可能同时关联多个远程仓库，例如同时推送到GitHub和Gitee：

git remote add github https://github.com/user/repo.git
git remote add gitee https://gitee.com/user/repo.git

数据同步操作

克隆仓库

完整复制远程仓库到本地：

git clone https://github.com/user/repo.git

克隆时指定本地目录名：

git clone https://github.com/user/repo.git my-project

获取远程更新

git fetch获取远程变更但不合并：

git fetch origin

查看特定分支的更新：

git fetch origin main

拉取与合并

git pull相当于fetch加merge：

git pull origin main

使用rebase方式拉取：

git pull --rebase origin main

推送本地提交

将本地分支推送到远程：

git push origin feature-branch

首次推送需设置上游分支：

git push -u origin feature-branch

分支管理策略

跟踪远程分支

创建本地分支并跟踪远程分支：

git checkout --track origin/dev

等价于：

git checkout -b dev origin/dev

删除远程分支

推送空分支到远程实现删除：

git push origin :old-branch

或使用更直观的语法：

git push origin --delete old-branch

分支同步问题

当远程分支已被删除时，清理本地缓存：

git fetch --prune

高级协作场景

强制推送

覆盖远程历史（慎用）：

git push --force origin main

更安全的强制推送方式：

git push --force-with-lease origin main

标签同步

推送所有标签到远程：

git push origin --tags

删除远程标签：

git push origin :refs/tags/v1.0

子模块更新

克隆包含子模块的仓库：

git clone --recurse-submodules https://repo.url

已有仓库初始化子模块：

git submodule update --init --recursive

冲突解决流程

拉取时冲突

当远程修改与本地修改冲突时：

git pull origin main
# 出现冲突后手动解决
git add conflicted-file.js
git commit -m "Resolve merge conflict"

推送被拒绝

当本地落后于远程时：

git push origin main
# 收到rejected错误后
git pull --rebase origin main
git push origin main

仓库镜像与迁移

完整镜像仓库

克隆裸仓库：

git clone --bare https://old-repo.com/project.git

推送到新仓库：

cd project.git
git push --mirror https://new-repo.com/project.git

部分历史迁移

仅迁移特定分支：

git clone --branch main --single-branch https://old-repo.com/project.git
cd project
git remote add new-origin https://new-repo.com/project.git
git push new-origin main

自动化操作示例

CI/CD集成脚本

典型的部署脚本示例：

#!/bin/bash
git fetch origin
git checkout production
git reset --hard origin/production
npm install
npm run build
pm2 restart all

钩子脚本应用

通过pre-push钩子运行测试：

#!/bin/sh
# .git/hooks/pre-push
npm test
if [ $? -ne 0 ]; then
  echo "Tests failed, push aborted"
  exit 1
fi