lazygit 入门完整指南：10 分钟上手动起来 Git 终端可视化操作

lazygit 入门完整指南：10 分钟上手动起来 Git 终端可视化操作

【免费下载链接】lazygitsimple terminal UI for git commands项目地址: https://gitcode.com/GitHub_Trending/la/lazygit

lazygit 是一款在终端里运行的 Git 可视化工具,把提交、切分支、变基这些常用操作变成按键即可完成的界面操作。这篇入门指南带你完成安装,认识界面,并练熟最常用的四个场景。

lazygit 快速上手:一条命令完成安装

最省事的方式是用包管理器直接装,以 macOS 和 Linux 为例:

brew install lazygit

Windows 用户可用scoop install lazygit,Debian/Ubuntu 较新版本可直接sudo apt install lazygit。装好后,进入任意 Git 仓库目录,输入lazygit回车。

第一眼你会看到一个三栏界面:左侧是待提交的文件列表,中间偏上是分支列表,中间偏下是带分支图形的提交历史,右侧默认显示状态或差异内容。界面底部有一条提示栏,实时告诉你当前面板的按键说明——不熟悉按键时,盯着它按就行。随时按?还能调出完整的快捷键菜单。

lazygit 界面认识:面板布局速览

各面板职责如下,熟悉后你的注意力基本只在四块区域之间移动:

导航逻辑很简单:按Tab在各面板间循环切换焦点,方向键移动光标,Enter深入查看,Esc返回上一层。所有面板通用/过滤列表、0聚焦主视图,所以一旦掌握这套逻辑,任何面板都能快速上手。

场景化实战:四个高频操作

提交改动:支持按行暂存

场景:你改了一个文件,但只想把其中一部分提交,其余留在工作区。

1. 在 Files 面板选中该文件,按Space整文件暂存
2. 按Enter进入右侧暂存视图,方向键移动到想选的位置
3. 按Space逐块或逐行勾选,然后按c写提交信息,Enter确认

效果:差异视图里被勾选的内容进入暂存区,提交后剩下的改动原样保留,不用再去记git add -p的交互流程。

切换分支:免命令操作

场景:你手头有多个功能分支,需要频繁来回切换。

1. Tab切到 Branches 面板
2. 方向键选中目标分支,按Space切换
3. 按n新建分支;按-一键回到上一个分支

效果:当前分支始终有醒目标记,切换前若有冲突改动会直接提示,比盲敲git checkout更安心。

查看提交历史:定位每次改动

场景:你想知道某行代码是哪次提交引入的,或者回看某次改动的完整内容。

1. Tab到 Commits 面板,方向键浏览带分支图形的历史
2. 选中提交后按Enter,在右侧查看该提交改动的文件
3. 按/输入文字过滤,快速缩小范围

效果:提交按作者着色,分支合并关系一眼可见,配合过滤功能,找一次改动通常只要几秒。

处理合并冲突:逐块解决

场景:把主分支合并进来时出现冲突,终端里一堆<<<<<<<标记看着头疼。

1. 冲突文件会出现在 Files 面板,选中它按Enter进入主视图
2. 按左右方向键在冲突块之间跳转,Space选择本侧或对方,hunk
3. 按b同时保留两侧,处理完按m打开菜单选 continue 继续合并

效果:冲突被拆成一个个小块逐个决策,解决过程可反复查看,按z还能撤销上一步选择。

lazygit 快捷键速查表

高频按键一览,按作用范围分组:

完整的按键说明可以在项目文档 docs/keybindings/Keybindings_en.md 里查到,快捷键定义源码见 pkg/config/keybinding.go。

进阶技巧与收尾

变基:在 Commits 面板按i启动交互式变基后,用ctrl+k/ctrl+j上下移动提交,s合并进下方提交,f做 fixup,d删除,最后按m选 continue 完成,整条历史立刻变得干净。摘樱桃:在某个提交上按C把它标记为"已复制",切到目标分支按V粘贴,多个提交也能一次搬运。Stash:按s把工作区改动收起来,之后在 Stash 面板里按Space应用或按g应用并删除记录,切分支前再不用纠结要不要先提交。

先按?熟悉一遍按键,再在你自己的仓库里把上面四个场景各跑一遍。上手之后,你可以打开 docs/Config.md 按习惯调整主题和按键。

【免费下载链接】lazygitsimple terminal UI for git commands项目地址: https://gitcode.com/GitHub_Trending/la/lazygit