git pull-三亩地-编程学习日记

文章目录

1.简介
2.格式
3.选项
4.示例
- 4.1 基础用法
- 4.2 使用 rebase 代替 merge（推荐）
- 4.3 只允许快进
- 4.4 自动暂存本地修改
- 4.5 拉取指定分支到本地指定分支
5. 注意
- 5.1 `git pull` vs `git fetch`
- 5.2 解决 `git pull` 产生的合并冲突
- 5.3 避免“丑的”合并提交
- 5.4 常用别名设置
6. 小结
参考文献

1.简介

git pull是 Git 中最常用的命令之一，用于从远程仓库拉取最新代码并合并到当前分支。

它实际上是两个命令的组合：

gitfetch +gitmerge

git fetch：从远程下载最新代码（不自动合并）
git merge：将下载的代码合并到当前分支

⚠️git pull会自动执行合并，可能会产生合并提交。如果希望避免自动合并，可以使用git pull --rebase。

2.格式

gitpull[<options>][<repository>[<refspec>]]

repository 为远程仓库名称，指定从哪个远程仓库拉取，默认为 origin。

refspec 为引用规格，用于指定拉取哪些引用（分支/标签），以及如何映射到本地引用。它的格式灵活，可以是以下几种形式：

形式	示例	说明
`<分支名>`	`main`	拉取远程分支，并合并到当前分支
`<分支名>:<本地分支名>`	`main:feature`	拉取远程分支，并合并到指定的本地分支
`+<分支名>`	`+main`	强制拉取（允许非快进更新）
`<标签名>`	`v1.0.0`	拉取指定标签
`refs/heads/:refs/remotes/origin/`	（默认）	拉取所有分支到远程跟踪分支

3.选项

-r,--rebase使用 rebase 方式合并，而不是 merge（保持线性历史） --ff-only 只允许快进合并，如果不能快进则报错 --no-ff 强制创建合并提交（即使可以快进）--autostash拉取前自动暂存本地未提交的修改，拉取后自动恢复 --no-commit 拉取并合并，但不自动提交 -v,--verbose显示详细信息--all拉取所有远程分支的更新

4.示例

4.1 基础用法

# 拉取 origin 远程的 main 分支，并合并到当前分支gitpull origin main# 如果当前分支已关联远程分支，直接执行gitpull

4.2 使用 rebase 代替 merge（推荐）

# 拉取并变基，保持线性历史gitpull--rebaseorigin main

git pull --rebase=git fetch+git rebase，而不是默认的git fetch + git merge。

使用--reabase选项可以使项目提交历史变成直线，没有分叉，非常整洁。

简单来说：它把你本地独有的提交“挪”到远程最新提交的后面，而不是创建一个合并提交来“汇合”，即可以消除Merge branch 'main' of <repository path>这种 commit 记录。建议使用 -r（–rebase）选项。

4.3 只允许快进

# 只能快进，否则报错（避免意外创建合并提交）gitpull --ff-only origin main

4.4 自动暂存本地修改

# 拉取前自动 stash，拉取后自动 stash popgitpull--autostashorigin main

4.5 拉取指定分支到本地指定分支

# 将远程 dev 分支拉取到本地的 feature 分支gitpull origin dev:feature

5. 注意

5.1`git pull`vs`git fetch`

命令	行为	适用场景
`git fetch`	只下载，不合并	先查看远程更新，再决定是否合并
`git pull`	下载 + 自动合并	确信没有冲突，快速同步

5.2 解决`git pull`产生的合并冲突

# 拉取时产生冲突gitpull origin main# CONFLICT in main.go# 手动解决冲突后gitadd.gitcommit-m"Merge remote-tracking branch 'origin/main'"# 或者放弃合并gitmerge--abort

5.3 避免“丑的”合并提交

# 推荐：使用 rebase 保持线性历史gitpull--rebaseorigin main# 或者设置为默认行为gitconfig--globalpull.rebasetrue

5.4 常用别名设置

gitconfig--globalalias.pu"pull --rebase"gitconfig--globalalias.puf"pull --rebase --autostash"# 使用别名gitpu origin maingitpuf origin main

6. 小结

需求	命令	说明
普通拉取（默认）	`git pull origin main`	下载 + 合并（可能产生合并提交）
拉取并变基（推荐）	`git pull --rebase origin main`	保持线性历史
只允许快进	`git pull --ff-only origin main`	不能快进时报错，避免意外合并
自动暂存本地修改	`git pull --autostash origin main`	拉取前自动 stash，拉取后自动恢复
查看远程更新（不合并）	`git fetch origin`	先看再决定

一句话总结：git pull=git fetch+git merge，是同步远程代码最常用的命令。推荐团队统一使用git pull --rebase保持线性历史，避免出现“丑的”合并提交。如果有本地未提交的修改，可以配合--autostash使用。

参考文献

Git - git-pull Documentation

日记详情

git pull