► 项目概览

lazygit 是一个基于终端的 Git 命令可视化工具，通过简易的 TUI（文本用户界面）提升 Git 操作效率。开发者无需记忆复杂命令，即可完成分支管理、提交、合并等操作。

► 核心亮点

▸ 终端内可视化：直观展示仓库状态（分支树、修改文件、提交历史）
▸ 快捷键驱动：键盘快速操作，减少命令行输入
▸ 跨平台支持：Windows/macOS/Linux，兼容 tmux、iTerm2、Windows Terminal
▸ 功能全覆盖：暂存/提交、冲突解决、贮藏、Rebase、远程同步等

► 安装指南

▸ 主流包管理器安装

bash

# macOS (Homebrew)
brew install lazygit

# Ubuntu/Debian (apt)
sudo add-apt-repository ppa:lazygit-team/release
sudo apt-get install lazygit

# Windows (Chocolatey)
choco install lazygit

▸ 手动安装（Go 环境）

bash

go install github.com/jesseduffield/lazygit@latest

► 快速入门

▸ 启动与界面

在 Git 仓库目录执行：

bash

lazygit

界面分为四个主要区域：

1. {文件列表}：显示修改/新增/删除的文件（←→导航）
2. {分支视图}：展示本地/远程分支树（空格检出分支）
3. {提交面板}：提交历史与操作（c 创建提交）
4. {操作菜单}：快捷键提示（按 ? 查看全部）

▸ 高频操作

功能	快捷键
暂存文件	空格键
提交变更	c → 输入信息
创建新分支	n
合并分支	m
推送到远程	P (大写)
拉取远程更新	p (小写)

► 进阶技巧

▸ 解决冲突

1. 进入冲突文件 → 按 ←→ 选择冲突区块
2. 使用 空格键 选择保留当前/传入版本
3. 按 M 标记冲突已解决

冲突解决后需手动提交变更！

▸ 交互式 Rebase

1. 提交面板选中目标提交 → 按 r
2. 使用 j/k 移动提交顺序
3. 按 s 压缩提交或 e 编辑提交信息

► 配置与自定义

配置文件路径：
~/.config/lazygit/config.yml
常用自定义项：

yaml

# 修改主题配色
gui:
  theme:
    activeBorderColor: [blue, bold]
    inactiveBorderColor: [gray]

# 自定义快捷键
keybinding:
  commits: 
    squashDown: 'S'

支持主题网站：
https://github.com/jesseduffield/lazygit/blob/master/docs/Theme.md

► 注意事项

需确保系统已安装 Git 2.0+
部分功能（如文件差异对比）依赖 git diff 命令兼容性
遇到界面异常时尝试按 R 刷新或重启终端

项目官网：
https://github.com/jesseduffield/lazygit
官方文档：
https://github.com/jesseduffield/lazygit/tree/master/docs