lazygit 上手指南：在终端用键盘流掌控 Git 工作流与分支管理

在终端里敲 Git 命令久了，总会遇到几个让人头疼的时刻：想 git add 某个文件里的某几行，却要先 git add -p 再费劲地挑选 hunk；想把最近几个提交重新整理一下，git rebase -i 的交互界面虽然强大，但那一堆 pick、squash 的单词和哈希值，总让人在编辑器中迷失方向。如果你熟悉终端操作，却又厌倦了这些繁琐的输入，lazygit 可能就是那个让你重新爱上 Git 的桥梁。它不是一个花哨的图形界面，而是一个运行在终端里的 TUI（文本用户界面），让你用键盘在几个面板之间快速穿梭，完成从暂存文件到变基分支的几乎所有操作。

lazygit 的核心设计理念很朴素：把 Git 的复杂操作封装成一个个直观的按键，让你不用记忆那些晦涩的 flag，就能完成日常开发中的绝大多数任务。它由 Jesse Duffield 用 Go 语言开发，是一个开源项目，目前在 GitHub 上拥有超过 7 万颗星。你可以把它看作一个“快捷键驱动的 Git 控制台”，它把文件状态、提交历史、分支列表和暂存区（Stash）拆分成了不同的面板，通过数字键 1-5 或 Tab 键即可快速切换。这种组织方式让你对仓库的全局状态一目了然，而不是像在命令行里那样，需要反复输入 git status 和 git log 来拼凑信息。

安装与首次启动：五分钟上手

lazygit 的安装非常简单，它支持几乎所有主流平台。如果你是 macOS 用户，可以直接使用 Homebrew：

brew install lazygit

Windows 用户可以用 Scoop，Linux 用户则可以用 apt 或者直接下载预编译的二进制文件。安装完成后，在任意 Git 仓库目录下输入 lazygit 即可启动。为了更顺手，很多人会在 shell 配置文件里加一个别名，比如 alias lg="lazygit"，这样只需输入 lg 就能呼出界面。

启动后，你会看到一个由几个面板组成的界面。默认情况下，最左侧是状态栏和分支面板，中间是文件面板，右侧是提交历史面板。刚开始可能会觉得信息有点多，但不用担心，按 ? 键可以随时调出当前面板的快捷键帮助，这是 lazygit 最贴心的设计之一——它鼓励你在使用中学习，而不是死记硬背。

文件暂存与提交：从整文件到单行

对于日常的提交工作，lazygit 的体验可以用“行云流水”来形容。在文件面板中，未暂存的更改会显示在上方，已暂存的更改会显示在下方。按 Space 键可以暂存或取消暂存整个文件，按 a 键则可以一键暂存所有更改。当你准备好提交时，按 c 键会弹出一个提交信息输入框，输入后回车即可完成提交。

但 lazygit 真正强大的地方在于它对“暂存区块”（Hunk）的精细控制。假设你修改了一个文件，但只想把其中一部分改动提交到当前 commit，其余部分留到下次。在命令行里，你需要用 git add -p 进入那个略显笨拙的交互模式。而在 lazygit 中，你只需在文件面板中按 Enter 键，进入该文件的差异视图。此时，你可以用 ↑ 和 ↓ 键逐行移动光标，按 Space 键暂存光标所在的整行，或者按 v 键进入可视化选择模式，然后移动光标选中多行，再按 Space 批量暂存。这种“所见即所得”的暂存方式，让提交粒度变得极其精确，也让你对每一次提交的内容有了更强的掌控感。

交互式变基：整理提交历史的利器

如果说逐行暂存是 lazygit 的“绝活”，那么交互式变基（Interactive Rebase）就是它的“招牌菜”。在命令行中，git rebase -i 会打开一个文本编辑器，让你修改一堆提交指令。虽然功能强大，但视觉反馈几乎为零，很容易出错。lazygit 将这个过程变成了一个可视化的列表操作。

在提交历史面板中，选中一个提交，然后按 i 键，即可开始对该分支上的提交进行交互式变基。此时，每个提交前面都会出现一个操作标记，默认是 pick。你可以移动光标到某个提交上，然后按特定的键来改变其操作：

• p：标记为 pick，保留该提交。
• e：标记为 edit，在变基过程中暂停，以便修改该提交的内容或信息。
• d：标记为 drop，删除该提交。如果后续提交依赖于它，可能需要在变基过程中解决冲突。
• s：标记为 squash，将该提交合并到上一个提交中，并合并提交信息。

完成标记后，按 Enter 键确认，lazygit 就会开始执行变基。整个过程有清晰的进度提示，如果遇到冲突，它会自动跳转到冲突文件，引导你解决。这种交互方式将原本抽象的变基过程变得直观且可控，极大降低了误操作的风险。例如，如果你想将最近三个提交合并成一个，只需在交互式变基界面中，将后两个提交标记为 squash，然后确认即可，lazygit 会合并提交信息并让你编辑最终的提交说明。

分支管理：在终端里完成一切

分支管理同样是 lazygit 的强项。在分支面板中，你可以按 Space 键快速切换（Checkout）到选中的分支，按 n 键基于当前分支新建分支，按 d 键删除分支。更实用的是，你可以用 [ 和 ] 键在“本地分支”和“远程分支”视图之间切换，方便地跟踪远端动态。

lazygit 还支持“复制提交”（Cherry-pick）操作。在提交历史面板中，按 C（Shift + c）可以复制选中的提交，然后在另一个分支上按 V（Shift + v）将其粘贴（Cherry-pick）到当前分支。这个功能在需要快速移植某个修复时非常高效，省去了在命令行中查找和输入长哈希值的过程。

此外，按 P 键可以推送当前分支到远端，按 p 键可以拉取远端更新。这些高频操作都被绑定到了单个按键上，让整个工作流变得极其紧凑。

定制与性能边界：让它更贴合你的习惯

lazygit 是高度可定制的。你可以通过一个 YAML 配置文件来修改几乎所有的按键绑定、界面主题和 Git 命令行为。配置文件的位置通常在 ~/.config/lazygit/config.yml。例如，如果你觉得默认的提交按键 c 不好记，可以将其改为 w。你还可以自定义一些自定义命令，将常用的 Git 操作序列化成一个按键。

不过，在使用 lazygit 时，有两个边界是值得注意的。首先是按键冲突，由于快捷键众多，且不同面板的按键可能有不同的含义，初学者可能会有一段适应期。例如，在文件面板中按 d 是放弃更改，而在分支面板中按 d 是删除分支。好在 lazygit 的 ? 帮助面板非常完善，且支持模糊搜索快捷键，可以帮你快速定位。

其次是大仓库性能。虽然 lazygit 的响应速度在绝大多数情况下都非常出色，但如果你面对的是一个包含数十万文件或超长提交历史的巨型仓库（如 Monorepo），在初次加载或执行某些全量操作时，可能会有可感知的延迟。不过，lazygit 也提供了过滤功能（按 / 键），可以快速筛选文件或提交列表，这在一定程度上缓解了性能压力。

结论：值得尝试的终端 Git 工作流

lazygit 并非要完全替代命令行，而是为那些希望保留终端环境、却不想在记忆命令和解决交互问题上耗费精力的开发者，提供了一个更优雅的中间层。它将 Git 的复杂操作转化为直观的键盘流，让你把注意力从“如何敲命令”转移到“如何组织代码”上。如果你已经对繁琐的 git add -p 和 git rebase -i 感到厌倦，不妨花五分钟安装并启动它，按 ? 键开始探索，它很可能会成为你终端工作流中不可或缺的一部分。