[Git] [Tool] LazyGit操作手册

2026年4月27日21:52:52 DeepSeek/豆包 辅助生成

LazyGit操作手册

🧰 安装

macOS

brew install lazygit

Ubuntu / Debian

sudo apt update
sudo apt install lazygit

Windows (Scoop)

scoop install lazygit

任意系统 (Go)

go install github.com/jesseduffield/lazygit@latest

验证安装：

lazygit --version

---

🖥️ 启动与界面总览

在任意 Git 仓库目录下执行：

lazygit

五个核心面板

屏幕分为五个区域，使用方向键或 h / l 左右切换，j / k 或 ↑ / ↓ 上下移动焦点。

多数版本也支持 1 ～ 5 数字键直接跳转到对应面板，Tab 可循环切换。

编号	面板	作用
1	Files	工作区 / 暂存区文件
2	Branches	本地和远程分支
3	Commits	当前分支的提交历史图
4	Stash	临时保存的未提交改动
5	Merge Conflicts	合并 / 变基冲突 (出现时可见)

全局快捷键

快捷键	功能
?	查看当前界面的全部快捷键
x	打开帮助菜单（列出所有绑定）
q	退出 LazyGit
Esc	取消当前操作
Ctrl + R	刷新仓库状态
@	打开命令面板
z	撤销上一步 Git 操作
Z	重做被撤销的操作

---

📁 文件操作 (Files 面板)

暂存与取消暂存

• 空格 — 暂存或取消暂存当前文件
• a — 一次性暂存所有文件，或一次性取消所有暂存

精细化暂存（只暂存部分行）

1. 选中文件，按 回车 进入差异视图
2. 在差异视图中：
   • 空格 — 暂存/取消当前选中的行或块
   • V (Shift + v) — 启动范围选择模式，用方向键选择多行，再按 空格 批量暂存
   • a — 快速暂存当前光标所在的整个代码块（hunk）
3. 退出差异视图：按 Esc

提交

• c — 打开输入框，填写提交信息后回车提交
• C (Shift + c) — 使用外部编辑器（如 Vim）编写多条提交信息

拉取与推送

• p (小写) — 从远程拉取当前分支
• P (大写) — 将当前分支推送到远程

放弃改动

• 在 Files 面板选中文件，按 d — 丢弃该文件的所有本地修改
• 在差异视图内按 d — 只丢弃当前选中的一行或一块

---

🌿 分支管理 (Branches 面板)

快捷键	功能
n	基于当前提交新建分支
空格	切换到选中的分支
M (Shift + m)	将选中的分支合并到当前分支
d	删除选中的本地分支
r	重命名选中的分支
f	抓取所有远程分支信息（fetch）
w	在选中分支上创建工作树（worktree）
-	快速切换回上一次签出的分支

---

🕰️ 提交历史操作 (Commits 面板)

查看与挑选

• 回车 — 查看选中提交的完整差异
• C (Shift + c) — 复制选中的提交（为 cherry-pick 准备）
• V (Shift + v) — 将之前复制的提交粘贴（cherry-pick）到当前分支

交互式变基 (rebase -i)

• 选中想要变基的起点提交，按 i 进入交互式变基界面

在变基界面中：

• p — 保留该提交（pick）
• r — 修改提交信息（reword）
• e — 修改提交内容（edit）
• s — 将该提交合并到上一个提交，并保留信息（squash）
• f — 将该提交合并到上一个提交，丢弃本条信息（fixup）
• d — 删除该提交（drop）
• Ctrl + J / Ctrl + K — 上下移动提交顺序
• 调整完毕后按 m 打开变基菜单，选择 continue 继续完成

---

📦 贮藏改动 (Stash)

创建贮藏

• 在 Files 面板按 s — 贮藏所有未提交的改动
• S (Shift + s) — 打开贮藏选项菜单（可只贮藏已暂存或未暂存的部分）

处理贮藏 (Stash 面板)

• 回车 — 查看该贮藏的详细差异
• a — 应用贮藏，保留贮藏内容（apply）
• p — 应用贮藏，并把贮藏从列表中移除（pop）
• d — 直接丢弃某个贮藏（drop）

---

⚔️ 冲突解决 (Merge Conflict 面板)

当出现合并或变基冲突时，该面板自动出现。

• 选中冲突文件，按 回车 进入差异对比视图
• 在每个冲突块上：
  • 空格 — 轮流选择「采用本地 / 采用远程」
  • b — 选择「保留双方」
• 标记冲突为已解决：c
• 所有冲突都解决后，按 m 选择 continue 完成合并或变基

---

⚙️ 常用配置

配置文件路径：~/.config/lazygit/config.yml

示例（拉取时使用 rebase）：

git:pull:rebase: true

更多配置项可参考 官方文档。

---

📋 常用快捷键速查表

全局

快捷键	功能
q	退出
? / x	查看帮助
Esc	取消
Ctrl + R	刷新
z	撤销
Z	重做

文件

快捷键	功能
空格	暂存 / 取消暂存
a	全部暂存 / 全部取消
c	提交
d	丢弃修改
回车	进入差异视图

分支

快捷键	功能
n	新建分支
空格	切换分支
M	合并到当前分支
d	删除分支
r	重命名分支
f	拉取远程

提交历史

快捷键	功能
C / V	复制 / 粘贴（cherry-pick）
i	启动交互式变基
回车	查看提交详情

贮藏

快捷键	功能
s	贮藏所有改动
S	贮藏选项菜单
a	应用贮藏
p	弹出贮藏（应用并删除）
d	删除贮藏

---