Lazygit: 从0到熟练使用，你需要的都在这里以前最常用sourceTree，后来用了一段时间fork，直到接触 l

lazygit：拥有 68K star，终端里的全能Git可视化工具

以前最常用sourceTree，后来用了一段时间fork，直到接触 lazygit，才发现这是最好的git客户端

本文已经非常全面，从接触到熟练掌握，所需要的所有细节都在这里。
虽然文章内容有点多，但只有2种内容：
- 【2Panels窗格】介绍了5个panel下常用的快捷键；
- 【3场景实例】包含了多个场景演示，都是很简单的内容，只需要简单几步即可完成一个操作。很多步骤都是重复的，全部看完实践一遍就可以掌握。
包含了以前不了解的worktree操作。近期靠AI对用到的一个开源软件提交贡献恰好也用到了这部分内容，操作起来非常方便。

标准流程示例：简单几个按键即可实现暂存、提交、拉取、推送

按键	说明
2	进入Files文件窗格
a	暂存所有文件；或选择单个文件，按Space暂存或选则单个文件，按Enter后，按a，按块或者行暂存
c	提交，输入commit信息
p	拉取
Shift+p	推送

窗口示例：

在命令行执行 lazygit 启用。推荐 git-bash，或者vscode等 IDE 中不推荐cmd/powershell，存在中文输入问题

0. Windows下通过scoop 安装lazygit

在github 官方仓库 github.com/jesseduffie… releases 中下载. 目前最新0.56.0 :windows下载: github.com/jesseduffie…

由于我是通过scoop安装的lazygit，本文所有内容也都是在这一环境下测试的。不清楚上面的版本是否会有不同。

配置lazygit

常见问题与配置建议

配色不可读：cmd/bash中，底部可用操作项默认黑底蓝字，难以辨认。见下方推荐配置：改为白色字体。
自动 fetch 导致command log被刷屏：见下方推荐配置：关闭自动fetch。
中文输入框不显示：在 cmd/PowerShell 下候选框不可见，建议改用 git-bash 或 VS Code（Cursor）集成终端运行 lazygit。

[!tip] 配置文件路径编辑 C:\Users\Administrator\AppData\Local\lazygit\config.yml

[!example] 推荐配置（提高底部提示可读性并避免 fetch 刷屏）

gui:
  theme:
    optionsTextColor:
      - white
git:
  autoFetch: false

运行lazygit

在目标仓库目录下执行 lazygit 即可

1. 通用快捷键

一切都要基于英文输入法区分大小写

在任何操作场合基本都共用的按键:

按键	功能	详情
1..5	快速切换Panel	左侧5个Panel，通过数字键1..5切换; lazygit最基本的概念、按键
?	查看更多快捷键绑定	每个Panel中都可以查看当前可用的快捷键。常用按键会在底部显示；
j	下一行
k	上一行
[	左移tab	Panel 可能有多个tab，向左切换
]	右移tab	在同一Panel中左右切换
Enter		确认进入Local branch，查看commits 进入commit，查看差异files 进入file，查看差异
C+o	复制	branchname/commithash/filaname
/	过滤
esc	退出/取消当前操作
+	循环放大窗格
q	退出lazygit

:	调用终端执行常规命令操作	比如代码commit后，需要执行 mvn clean package, 则按 : (即Shift+;)在弹出窗口中输入 mvn clean package

2. Panels窗格

1-5：左侧5个Panel，可通过数字直接激活。底部会显示激活窗格对应的可用快捷键与对应功能

1.Status Panel 状态

按键	次级按键	功能
1		激活Status Panel
Enter		lazygit打开过的最近仓库，选择一条切换
	j/k	下/上一行
	/	过滤

2.Files Panel 文件

文件、工作区、子模块通过 [ ] 左右切换至 Worktrees Submodules(不讨论)

Files文件

功能	按键	次级按键	详情
激活	2		激活Files Panel
stage/unstage	a		暂存所有
	Space		单个目录/文件：暂存/取消暂存
	Enter		选中文件，按Enter后可以按行暂存
		a	Enter后，按a，选择行
		v	Enter后，按v，进入多行选择模式
		←→↑↓	Enter后，可以在hunk(块)之间选择
discard	d		丢弃，不可恢复，谨慎操作
	D		重置
ignore	i		忽略文件、目录
		i	添加到 .gitignore 在团队中共享该忽略
		e	添加到 .git/info/exclude 只在本地忽略，不会被提交
commit	c		提交
	C(大写)		在外部编辑器编辑提交信息
fetch	f
pull	p		拉取：针对当前检出的分支。总是使用rebase，只能修改git配置： `git config --global pull.rebase true`
push	P(大写)		推送：针对当前检出的分支。
edit	e		编辑
	o		使用默认编辑器编辑
stash	s		贮藏
	S(大写)		更多贮藏选项
	?		查看按键绑定

Worktrees 工作区

工作树是更准确的翻译

git worktree 是一个非常有用的 Git 功能，它允许你同时签出同一个仓库的多个分支到不同的目录。

示例场景

我正在 rebuilld分支进行重构，工作区处于如此混乱的状态（有新的、被移动的、被删除的文件）。此时需要在 master分支上修复线上bug，那么我只需要基于 master分支创建一个工作区：路径(../hotfix、新分支 hotfix 。就会多一个 hotfix 的同级文件夹，在里面进行开发验证。
开源软件在我本地有自己的版本。今天优化了一个功能commitA，想提交PR给原作者。我不需要清理在用的工作目录，只需要基于原作者upstream分支创建一个工作区，应用commitA，然后推送提交就可以了。

原始git流程

# 1. 查看当前工作区
git worktree list

# 2. 为紧急修复创建新工作区：基于master分支创建hotfix分支，目录在../hotfix
$ git worktree add -b hotfix ../hotfix master

# 3. 切换到新工作区
cd ../hotfix

# 4. 进行修复并提交
git add .
git commit -m "紧急修复"

# 5. 返回主工作区，继续之前的工作
cd ../main-project

# 6. 完成后移除工作区
git worktree remove ../hotfix

lazygit操作

按键	次级按键/输入	说明
3		进入本地分支
j/k		移动至目标分支，这里是master
w		创建工作区
	../hotfix	目标路径
	hotfix	新建分支名称
		则本地分支已经变成hotfix 2-工作区下当前为hotfix

3.Local branches Panel 本地分支

通过 [ ] 左右切换至 Remotes Tags

功能	按键	次级按键	详情
激活	3
fetch	f		获取远程最新信息，是否有代码需要pull
pull	p		拉取：针对当前检出的分支
push	Shift+p		推送：针对当前检出的分支
checkout	Space		检出
new	n		创建分支
delete	d		删除分支
merge	M		合并到当前检出的分支
rebase	r		变基
		s	`Simple rebase onto main`(`简单变基到main`)
更多按键	?		查看按键绑定
filter	/		在本地分支中过滤，Enter选择
search	c		在本地、远程分支中搜索
worktree	w		在选定分支上创建工作区

4.Commits Panel

当前检出分支的commits记录

功能	按键	次级按键	详情
激活	4
Checkout	Space		检出当前commit
Rechange	r		修改提交信息
Tag	T		任意commit上添加tag
Amend	A		将当前暂存的文件合并到选择的commit中 1，按2，进入Files中暂存文件 2，按4，选择任何commit 3，按Shift+a
查看变更文件	Enter		查看变更文件
		Ctrl+w	忽略空白、tab、换行。等价于 `git diff -w`
		c	checkout,检出选定文件当前commit版本，并暂存
		e	edit，编辑选定文件，为最新版本，而非当前commit
		d	从当前commit中删除该文件，会引发rebase
Delete	d		删除提交
Revert	t		选择某个commit，回滚提交
Squash	s		1，选择单个或Shift+↓/↑选择多个 2，按s，合并到下方的提交
Fixup	f		将选择的提交合并到下方的提交，本次提交信息会丢失
Rebase	r		rebase变基
interactive rebase	i		start an interactive rebase.
更多按键	?		查看按键绑定
	,		移动到当前页第一项或者上一页
	.		移动到下一页
	/		搜索
	Ctrl+s		过滤，可以根据作者过滤:先移动到该作者提交的commit，再执行过滤。
	+		放大窗格

5.Stash Panel

按键	说明
5	激活
Space	应用
g	应用并删除
d	删除

3. 场景实例

按表格中按键顺序依次按下

标准流程：暂存、提交、拉取、推送

按键	说明
2	进入Files文件
a	暂存所有文件；或选择单个文件，按Space暂存或选则单个文件，按Enter后，按a，按块或者行暂存
c	提交，输入commit信息
p	拉取
Shift+p	推送

从远程创建本地分支并追踪

按键	次级按键	说明
3		进入本地分支
c		搜索远程分支名，选中目标（如 origin/feature-x）
Enter		检出并创建同名本地跟踪分支
	Enter	New Local branch

暂存/丢弃块/行

按键	次级按键	说明
2		进入 Files
j/k		移动到目标文件
Enter		进入文件
	j/k	移动至目标块
	a	单行/块选择模式
	v	进入、退出多行选择模式
	j/k	上下移动至目标行
	Space/d	Space 暂存选中行 d 丢弃选中行（不可逆，谨慎操作）
	Esc	返回Files

忽略文件

思路：在 Files 窗格，对选择的文件，按 i 进行 ignore

按键	次级按键	说明
2		进入Files文件
i		忽略
	i	添加到 .gitignore 需要提交，团队共享
	e	添加到 .git/info/exclude 不需要提交，个人

合并其他分支到当前分支

按键	功能
3	进入Local branches
j/k	移动，选择要合并的分支
Shift+m	合并
m	常规合并

根据author搜索提交记录

思路：按4，进入commits 方法1：选择目标作者提交的任一条commit，按Ctrl+s搜索，选择第一项方法2：任一提交记录上按Ctrl+s搜索，选择第三项：输入作者搜索，在弹框中输入或者选择作者

方法1示例

按键	次级按键	说明
4		进入commits
j/k		移动，选则目标作者提交的任一条记录
Ctrl+s		搜索
	Enter	第一项 `Filter by 'author <email>'`按Enter确认

cherry-pick 复制其他分支commits到当前检出分支

场景：当前检出分支为A，想将分支B上的commitA 复制到当前分支A 思路：按3进入 local branches，通过j/k定位到分支B，按 Enter 进入，按 j/k 到目标commitA，按 Shift+c 复制提交（可以通过j/k在多个commit上复制），按 4 进入当前检出分支的commits，按 Shift+v 粘贴

按键	说明
3	进入Local branches
j/k	移动，选择目标分支
Enter	进入目标分支
j/k	移动至目标commit
Shift+c	复制提交；可以多次移动复制
4	进入Commits （当前检出分支的commits）
Shift+v	粘贴到当前检出分支

Rebase 变基

最基本的Rebase

场景：

从 main 分支 checkout dev 分支: main ->dev

在 dev 分支依次提交了 dev.1 dev.2: main->dev.1->dev.2

此时 main 分支提交了 main.1: main->main.1

此时，想将 mian 分支同步到 dev 分支，可以在dev分支执行 git rebase main，此时dev分支的提交记录变为 main->main.1->dev.1->dev.2

对应lazygit操作：

按键	次级按键	说明
		前提：检出分支为dev分支
3		进入Local branches
j/k		选择master
r		rebase
	s	`Simple rebase onto main`(`简单变基到main`)

Rebase from marked base commit

场景解释：从master分支创建新分支dev，并提交dev.1 从dev分支创建新分支feature，并提交 feature.1, feature.2。此时的提交记录为 master->dev.1->feature.1->feature.2 然后你想将feature上的2次提交，改为从master上提交记录为 master->feature.1->feature.2

按键	次级按键	说明
		当前位于feature分支
4		进入commits
j		移动至 feature分支前的 commit，这里是 dev.1
Shift+b		标记从这里开始变基
3		进入本地分支
j/k		移动到master
r		变基
	s	`Simple rebase onto main`(`简单变基到main`)

interactive rebase演示：将commitA合并到commitB

按键	次级按键	说明
4		进入commits
i		start an interactive rebase；按下后commit前会显示`pick`标记
	Ctrl+j	move down；Shift+↓多选；
	Ctrl+k	move up
	f	标记当前commit为 `fixup` rebase后将合并下面标记为 `pick` 的提交，提交信息也将合并
	s	标记当前commit为 `squash` rebase后将合并到下面标记为 `pick` 的提交，提交信息将丢弃
	d	drop
	e	edit
	m	完成标记后，按`m`,选择`continue`,完成变基

思路：选择commitA，按 i start an interactive rebase，向下移动至commitB上方，标记commitA为fixup，按 m 查看rebase选项，选择 continue 完成rebase。

按键	次级按键	说明
4		进入Commits
j/k		移动至目标commitA
i		rebase
Ctrl+j		向下移动至commitB上方
f		标记commitA为 `fixup` 丢弃commitA信息
m		查看rebase选项
	Enter	默认continue，确认，完成

改写历史

将本次变更(未提交)合并到历史中某次commitB

或修正上一次提交适用于未推送，或允许强制推送思路：执行 Amend

按键	次级按键	说明
2		进入Files文件
Space		暂存文件
4		进入Commits
	j	向下移动，至目标CommitB
	/	也可以搜索，输入提交信息中关键字按Enter，定位到第一个匹配Commit
Shift+a		Amend到目标commitB
	r	需要时改写提交信息

将某文件恢复至某次提交

按键	次级按键	说明
4		进入commits
j/k		选中目标提交
Enter		进入提交，查看变更文件
	j/k	移动至目标文件
	c	checkout，检出选定文件当前版本

将当前分支重置到某次提交（Reset）

按键	说明
4	进入 Commits
j/k	选中目标提交
g	打开菜单选择默认：mixed reset Mixed：默认，保留工作区；=git reset commitId Soft：仅移动 HEAD； Hard：丢失工作区；=git reset --h commitId

回退（revert）指定提交

按键	说明
4	进入 Commits
j/k	选中目标提交
t	Revert 生成反向提交

生成补丁文件

按键	次级按键	说明
4		进入 Commits 提交
j/k		选择一个提交
Enter		进入 Diff files
	a	选中变更文件
	Ctrl+p	打开选项菜单
	y	Copy patch to clipboard（复制补丁到剪贴板）
		将剪贴板内容粘贴为 `xxx.patch` 即为补丁文件

Rebase Magic

从某次历史提交中删除一行注释最好删除的行不要与后续的提交在同一块中（如删除最后一行，后续又在最后添加代码），则位于同一块中。此时需要查看冲突，选择冲突文件，Enter进入，e编辑文件:删除注释行后保存关闭，Space选择位于下面的块，此时所有的冲突都解决。

处理冲突，本质就是用Space来选择上面的原变更块（hunk），还是下面的新变更。也可能需要先 e 编辑目标块，再 Space 选择它。如上一段所述。

按键	次级按键	次级按键		说明
4				进入 Commits 提交
j/k				选择一个提交
Enter				进入 Diff files
j/k				选择一个文件
Enter				进入文件
	a			进入逐行模式
	j/k			选择要删除的目标行
	Space			将选中行加入自定义补丁
	Esc			退出文件
	Ctrl+p			打开patch菜单
	d			从原来的提交中删除补丁
		Enter		如果出现了冲突，查看冲突
			Enter	选择冲突文件后，进入文件
			e	编辑文件，删除上一次提交中要删除的行
			Space	暂存下面的块，完成冲突处理
	Esc			返回Commits

Undo

删除commit后按 z 恢复回来。可以执行多次

差异

当前分支以CommitA为基准，比较后面的分支相比CommitA的变更

按键	次级按键	说明
4		进入commits提交
j/k		移动到CommitA
Shift+w
	Enter	选择第一条 `差异 CommitA`
	k	依次比较后面的相比A的变更

当前分支相比BranchB分支的变更

按键	次级按键	说明
4		进入commits提交
Shift+w
	j	选择第2条 `输入 ref 以 diff`
	Enter
		输入其他BranchB
	Tab	选中
	Enter	进入
	j	查看当前分支早期提交相比BranchB差异

打标签并推送

按键	说明
4	进入 Commits
j/k	选中要打标签的提交
Shift+t	打标签

4. 其他

rebase操作报错

warning: could not read '.git/rebase-merge/head-name': No such file or directory： git rebase --quit

Cursor、vscode中打开lazygit

Alt+F12 激活命令行，输入 lazygit 打开。

Lazygit: 从0到熟练使用，你需要的都在这里