Lazygit 完全指南：终端里的 Git 可视化操作

1 前言

Lazygit 是一个终端 Git 可视化工具（TUI），用 Go 编写，GitHub 75k+ stars。它把 git add、交互式变基、冲突解决、Cherry-Pick 等操作全部变成快捷键，不用再记命令参数。LazyVim 用户按 <leader>gg 即可在浮动窗口中直接使用。

前置条件：已安装 Git 并完成基本配置（user.name 和 user.email）。

2 Git 基础回顾

2.1 四大区域

Lazygit 的 Files 面板对应工作区和暂存区，Commits 面板对应本地仓库，Remotes 标签对应远程仓库。

2.2 命令行 → Lazygit 对照

记住这张表，后面的内容会反复用到这些快捷键。

3 安装与配置

3.1 各平台安装

macOS（Homebrew）：

brew install lazygit

Ubuntu / Debian：

LAZYGIT_VERSION=$(curl -s "https://api.github.com/repos/jesseduffield/lazygit/releases/latest" | \grep -Po '"tag_name": *"v\K[^"]*')
curl -Lo lazygit.tar.gz "https://github.com/jesseduffield/lazygit/releases/download/v${LAZYGIT_VERSION}/lazygit_${LAZYGIT_VERSION}_Linux_$(uname -m | sed 's/aarch64/arm64/').tar.gz"
tar xf lazygit.tar.gz lazygit
sudo install lazygit -D -t /usr/local/bin/

Arch Linux：

sudo pacman -S lazygit

Go 安装（任何平台）：

go install github.com/jesseduffield/lazygit@latest

验证安装：

lazygit --version

3.2 基础配置

Lazygit 的配置文件位于 ~/.config/lazygit/config.yml（Linux/macOS）。

常用配置项：

gui:
  language: zh-CN # 中文界面
  showRandomTip: false # 关闭启动提示
  nerdFontsVersion: '3' # 使用 Nerd Fonts 图标
  theme:
    activeBorderColor:
      - green
      - bold

os:
  editCommand: nvim # 外部编辑器

git:
  autoFetch: true # 自动 fetch（大仓库可关闭）
  paging:
    colorArg: always
    pager: delta --dark --paging=never # 使用 delta 作为 diff 工具（可选）

3.3 Shell 别名

推荐设置简短别名，加到 ~/.bashrc 或 ~/.zshrc：

alias lg='lazygit'

如果你希望退出 Lazygit 时自动切换到对应目录（在工作树间切换时特别有用）：

lg() {
    export LAZYGIT_NEW_DIR_FILE=~/.lazygit/newdir
    lazygit "$@"
    if [ -f $LAZYGIT_NEW_DIR_FILE ]; then
        cd "$(cat $LAZYGIT_NEW_DIR_FILE)"
        rm -f $LAZYGIT_NEW_DIR_FILE > /dev/null
    fi
}

4 界面概览

在任意 Git 仓库中运行 lazygit（或 lg），你会看到如下布局：

4.1 五大面板

Lazygit 的界面由左侧的五个面板和右侧的主视图组成：

4.2 面板导航

4.3 主视图

右侧的主视图会根据左侧选中项目自动显示对应内容：

• 选中文件 → 显示 diff
• 选中提交 → 显示提交详情和变更
• 选中分支 → 显示分支提交日志

按 Enter 可以进入更详细的视图（如逐行查看文件差异），按 0 可以聚焦主视图进行滚动。

5 核心操作

5.1 查看文件状态与差异

进入 Lazygit 后，Files 面板会自动显示所有已修改的文件（对应 git status）。

• 用 j / k 在文件间移动，右侧自动显示 diff
• 按 Enter 进入文件的逐行视图
• 用 { / } 调整 diff 上下文显示范围（显示更多或更少的周围代码）
• 按 ` 切换文件树视图（平铺 / 树形）

5.2 暂存与提交

这是 Lazygit 最常用的操作，对应命令行的 git add + git commit：

文件级暂存：

行级暂存（精确控制提交内容）：

1. 在 Files 面板选中文件，按 Enter 进入逐行视图
2. 按 space 暂存/取消暂存当前行
3. 按 v 开启范围选择模式，用 j/k 选择多行，再按 space 暂存
4. 按 a 暂存/取消暂存整个代码块（hunk）
5. 按 Tab 切换查看已暂存/未暂存的变更
6. 按 Esc 退出逐行视图

提交：

5.3 推送与拉取

注意 P 和 p 的大小写区别！推送用大写，拉取用小写。

如果当前分支没有设置上游分支，Lazygit 会弹出窗口让你选择远程仓库和分支名称。

5.4 撤销与重做

Lazygit 基于 git reflog 提供全局撤销，按 z 撤销、Z 重做，可以回退提交、变基、合并等操作。工作区和贮藏的变更不在撤销范围内。

其他常用撤销操作：Files 面板按 d 丢弃文件修改，space 取消暂存；Commits 面板按 g 打开 reset 选项，t 执行 revert。

6 分支管理

按 3 或用 h/l 切换到 Branches 面板。该面板有三个子标签，用 [ / ] 切换：

• Local Branches：本地分支
• Remotes：远程仓库及其分支
• Tags：标签管理

6.1 创建与切换分支

6.2 合并与变基

合并 vs 变基：

• 合并（M）：保留完整的分支历史，创建合并提交
• 变基（r）：将当前分支的提交"移动"到目标分支之上，产生线性历史

6.3 删除分支

选中要删除的分支，按 d，Lazygit 会弹出菜单让你选择：

• 仅删除本地分支（对应 git branch -d）
• 仅删除远程分支（对应 git push origin --delete）
• 同时删除本地和远程分支

如果分支有未合并的提交，Lazygit 会提示你确认是否强制删除。

6.4 远程分支

按 ] 切换到 Remotes 子标签：

7 交互式变基

命令行中 git rebase -i 需要在编辑器里手写 pick/squash/fixup 指令，而 Lazygit 把这一切变成了快捷键。

7.1 基本操作

在 Commits 面板（按 4），你可以直接对提交执行变基操作：

这些操作会自动启动交互式变基。Lazygit 在后台处理所有复杂性，你只需专注于想做什么。

7.2 高级用法

7.3 实战场景

场景 1：提交消息写错了

在 Commits 面板找到那条提交，按 r，修改消息后 Enter 确认。

场景 2：多个小提交合并为一个

1. 用 shift+下 选中要合并的多个连续提交
2. 按 s（squash）将它们压缩为一个
3. 编辑合并后的提交消息

场景 3：删除中间某个不需要的提交

在 Commits 面板找到那条提交，按 d（drop）。如果后续提交依赖了该提交的修改，可能需要解决冲突。

场景 4：调整提交顺序

选中要移动的提交，用 ctrl+k（上移）或 ctrl+j（下移）调整位置。

8 高级功能

8.1 Cherry-Pick（拣选）

Cherry-Pick 可以将其他分支的特定提交复制到当前分支：

1. 切换到源分支，在 Commits 面板找到目标提交
2. 按 C（大写）复制该提交（可复制多个）
3. 切换回目标分支
4. 按 V（大写）粘贴（Cherry-Pick）
5. 按 Esc 取消选择（重置拣选列表）

8.2 Bisect（二分查找）

当你知道某个 bug 是在某次提交引入的，但不确定是哪一次时，二分查找非常有用：

1. 在 Commits 面板按 b，打开二分查找菜单
2. 标记当前提交为 bad（有 bug）或 good（无 bug）
3. Lazygit 自动跳转到中间的提交，让你继续标记
4. 重复标记直到定位到引入 bug 的那次提交

这比手动 git bisect 直观得多。

8.3 Stash（贮藏）

贮藏功能可以暂时保存未提交的修改，切换到其他工作后再恢复：

在 Files 面板创建贮藏：

贮藏选项包括：贮藏所有变更、仅贮藏已暂存的、仅贮藏未暂存的。

在 Stash 面板管理贮藏（按 5）：

8.4 Worktrees（工作树）

工作树允许你在同一仓库中同时检出多个分支到不同目录，无需来回切换和 stash：

• 在 Branches 面板按 w 打开工作树选项
• 选择创建新工作树，指定分支和路径
• 使用 Enter 切换到其他工作树
• 按 d 删除不再需要的工作树

8.5 自定义补丁（Rebase Magic）

这是 Lazygit 最独特的功能之一——从旧提交中提取或移除特定的代码改动：

1. 在 Commits 面板选中目标提交，按 Enter 查看文件
2. 选中文件，按 Enter 进入逐行视图
3. 用 space 选择要操作的行，添加到自定义补丁
4. 按 ctrl+p 打开自定义补丁选项：
   • 从该提交中移除选中的改动
   • 将选中的改动拆分为新提交
   • 将补丁反向应用到暂存区

8.6 自定义命令

Lazygit 支持在配置文件中定义自定义命令，扩展其功能。

在 ~/.config/lazygit/config.yml 中添加：

customCommands:
  - key: '<c-p>'
    description: '推送到所有远程仓库'
    command: 'git remote | xargs -I {} git push {} {{.SelectedLocalBranch.Name}}'
    context: 'localBranches'
    loadingText: '推送中...'

你还可以在 Lazygit 中按 : 直接执行任意 Shell 命令。

9 冲突解决

合并、变基、Cherry-Pick 都可能产生冲突。Lazygit 的冲突解决界面比命令行直观得多：

冲突发生时，Files 面板会显示冲突文件。选中后按 Enter 进入冲突解决视图，界面高亮显示 ours 和 theirs 两个版本：

所有冲突解决后，按 m 打开选项菜单，选择「继续」完成操作；或选择「中止」放弃。

10 LazyVim 集成

LazyVim 通过 lazygit.nvim 内置了 Lazygit 集成，开箱即用。工作流：编写代码 → <leader>gg 打开 Lazygit → 暂存、提交、推送 → q 回到编辑器，全程不离开终端。

在 Lazygit 中按 e 编辑文件会调用外部编辑器，LazyVim 环境下通常已自动配置为 Neovim。如需手动设置，在 ~/.config/lazygit/config.yml 中添加 os.editCommand: nvim。

11 补充技巧

11.1 Tag 管理

在 Branches 面板按 ] 切换到 Tags 子标签：

在 Commits 面板中也可以为特定提交创建标签：选中提交后按 T。

11.2 双远程推送

在 Lazygit 的 Remotes 标签中按 n 添加第二个远程仓库（如 Gitee），之后可以分别对不同远程进行 fetch 和 push。

如果想一次 P 推送到多个平台，可以用 git remote set-url --add origin <第二个地址> 为 origin 添加多个推送地址，或者通过 Lazygit 的自定义命令实现。

12 常见问题

13 快速参考

13.1 全局快捷键

13.2 Files 面板

13.3 Commits 面板

13.4 Branches 面板

13.5 Stash 面板

13.6 冲突解决

14 参考链接

• Lazygit GitHub 仓库
• Lazygit 中文按键绑定
• Lazygit 自定义命令文档
• lazygit.nvim（LazyVim 集成插件）
• LazyVim 完全指南（本站）