git pull 命令

简介

git pull 是 Git 中用于从远程仓库拉取并合并更改的命令。它实际上是 git fetch 和 git merge 的组合。

基本概念

什么是拉取

拉取是从远程仓库获取最新更改并合并到当前分支的过程。它包含两个步骤：

1. fetch：从远程获取最新更改
2. merge：将远程更改合并到当前分支

Pull vs Fetch

特性	Pull	Fetch
操作	fetch + merge	只获取，不合并
工作区	自动合并	不改变工作区
安全性	可能产生冲突	更安全
使用场景	快速同步	需要检查后再合并

命令语法

# 基本拉取
git pull [远程仓库] [分支名]

# 拉取当前分支
git pull

# 使用 rebase 拉取
git pull --rebase

查看帮助文档

$ git pull --help

常用选项

选项	说明
--rebase	使用 rebase 而不是 merge
--no-rebase	使用 merge（默认）
--ff-only	只允许快进合并
--no-ff	即使可以快进也创建合并提交
--squash	压缩合并
--no-commit	合并后不自动提交
-v, --verbose	详细输出
-q, --quiet	静默模式
--no-verify	跳过 pre-merge-commit 钩子
--autostash	自动暂存未提交的更改
--allow-unrelated-histories	允许合并不相关的历史

基本使用

1. 基本拉取

# 拉取当前分支的远程更新
$ git pull

# 拉取指定远程和分支
$ git pull origin main

# 拉取并设置上游（首次）
$ git pull -u origin main

2. 使用 Rebase 拉取

# 使用 rebase 拉取（保持线性历史）
$ git pull --rebase origin main

# 配置默认使用 rebase
$ git config --global pull.rebase true

3. 拉取所有远程分支

# 拉取所有远程分支的更新
$ git pull --all

4. 自动暂存未提交的更改

# 拉取前自动暂存，拉取后自动恢复
$ git pull --autostash origin main

5. 只允许快进合并

# 只允许快进合并（如果有冲突会失败）
$ git pull --ff-only origin main

实际应用场景

场景1：同步远程更新

# 拉取远程主分支的更新
$ git pull origin main

场景2：使用 Rebase 保持线性历史

# 使用 rebase 拉取
$ git pull --rebase origin main

# 或配置为默认
$ git config pull.rebase true
$ git pull

场景3：拉取时有未提交的更改

# 自动暂存未提交的更改
$ git pull --autostash origin main

场景4：拉取并检查

# 先 fetch 查看
$ git fetch origin
$ git log HEAD..origin/main

# 确认后合并
$ git pull origin main

常见问题和解决方案

问题1：拉取冲突

错误信息：

Auto-merging file.txt
CONFLICT (content): Merge conflict in file.txt

解决方案：

# 解决冲突
$ git status
$ vim conflicted-file.txt

# 标记已解决
$ git add conflicted-file.txt

# 完成合并
$ git commit

问题2：拉取失败（有未提交的更改）

错误信息：

error: Your local changes to the following files would be overwritten by merge

解决方案：

# 方案1：暂存更改
$ git stash
$ git pull
$ git stash pop

# 方案2：自动暂存
$ git pull --autostash

# 方案3：提交更改
$ git add .
$ git commit -m "WIP"
$ git pull

问题3：拉取后历史混乱

解决方案：

# 使用 rebase 保持线性历史
$ git pull --rebase origin main

# 或配置为默认
$ git config pull.rebase true

问题4：拉取了错误的远程

解决方案：

# 查看远程配置
$ git remote -v

# 重置到拉取前
$ git reset --hard ORIG_HEAD

最佳实践

1. 使用 Rebase 保持线性历史

# 配置默认使用 rebase
$ git config --global pull.rebase true

# 或每次指定
$ git pull --rebase origin main

2. 拉取前检查状态

# 拉取前查看状态
$ git status

# 有未提交更改时先处理
$ git stash
$ git pull
$ git stash pop

3. 使用 Fetch 先检查

# 先 fetch 查看更新
$ git fetch origin
$ git log HEAD..origin/main

# 确认后 pull
$ git pull origin main

4. 定期拉取

# 开始工作前拉取
$ git pull origin main

# 推送前拉取
$ git pull origin main
$ git push origin main

总结

git pull 是同步远程更新的便捷命令：

1. 基本用法：git pull origin branch 拉取并合并
2. 使用 Rebase：git pull --rebase 保持线性历史
3. 自动暂存：git pull --autostash 处理未提交的更改
4. 安全方式：先 git fetch 检查，再决定是否 pull

关键要点：

• ✅ 使用 --rebase 保持线性历史
• ✅ 拉取前检查状态
• ✅ 定期拉取保持同步
• ✅ 有冲突时仔细解决
• ❌ 不要在有未提交更改时强制拉取