# LazyGit 内部工作流程
┌──────────────┐     ┌──────────────┐     ┌──────────────┐
│   用户操作   │ ──▶ │   TUI 渲染   │ ──▶ │  Git 执行   │
│  (键盘/鼠标) │     │  (gocui)    │     │ (libgit2)   │
└──────────────┘     └──────────────┘     └──────────────┘

# 方式一：Homebrew（推荐）
brew install lazygit

# 方式二：MacPorts
sudo port install lazygit

# Ubuntu/Debian
sudo apt-get install lazygit

# Fedora
sudo dnf install lazygit

# Arch Linux
sudo pacman -S lazygit

# Snap
snap install lazygit

# 方式一：Scoop
scoop install lazygit

# 方式二：Chocolatey
choco install lazygit

# 方式三：WinGet
winget install JesseDuffield.LazyGit

# 安装最新版本
go install github.com/jesseduffield/lazygit@latest

# 或安装特定版本
go install github.com/jesseduffield/lazygit@latest

# 克隆仓库
git clone https://github.com/jesseduffield/lazygit.git
cd lazygit

# 编译
make build

# 安装
sudo make install

# 进入 Git 仓库目录
cd my-project

# 启动 LazyGit
lazygit

# Stage 单个文件
s

# Unstage 单个文件
u

# Stage 所有文件
a

# 查看文件差异
d

# 放弃文件更改
D

# 创建提交
c

# 修改最近提交
w

# Squash 提交（压缩）
r

# 查看提交历史
h

# Cherry-pick 提交
C

# 新建分支
n

# 切换分支
b

# 删除分支
d

# 合并分支
m

# 重命名分支
R

# Fetch 远程
f

# Pull 远程
P

# Push 到远程
p

# 查看远程
o

# 进入 rebase 模式
r

# 在 rebase 界面中：
# - 选择提交
# - p: pick（保留）
# - s: squash（压缩）
# - d: drop（删除）
# - e: edit（编辑）
# - r: reword（修改信息）
# - f: fixup（压缩并保留消息）

# 保存并完成
:write
:quit

# 打开 LazyGit
lazygit

# 进入合并冲突界面
m

# 选择文件解决冲突
# - 选择ours版本
# - 选择theirs版本
# - 手动编辑

# 标记为已解决
space

# 继续 rebase
c

# 创建 stash
s

# 查看 stash 列表
stash 面板

# 应用 stash
a

# 应用并删除 stash
A

# 删除 stash
d

# 查看 stash 内容
d

# 进入子模块
submodule 面板

# 更新子模块
u

# 初始化子模块
i

# 优先级（从高到低）
~/.config/lazygit/config.yml
~/.lazygit.yml
./.lazygit.yml

# ~/.config/lazygit/config.yml

# 主题配置
gui:
  theme:
    activeBorderColor:
      - green
    selectedLineBgColor:
      - blue

# 默认分支
git:
  defaultBranch: main

# 别名
promptToSquashWithinFirstCommit: true

# 在 ~/.gitconfig 中添加
[alias]
    lg = lazygit
    lga = lazygit --all

# 1. 启动 LazyGit
lazygit

# 2. 查看状态
# → 文件面板显示已修改文件

# 3. Stage 要提交的文件
s

# 4. 创建提交
c

# 5. Push 到远程
p

# 1. 从 main 创建新分支
n

# 2. 输入分支名
feature/my-feature

# 3. 开发并提交
c

# 4. Rebase 到最新 main
r
# → 选择 main 分支
# → 自动 rebase

# 5. Push 到远程
p

# 6. 创建 PR/MR

# 1. Pull 远程更改
P

# 2. 发现冲突
# → LazyGit 显示冲突文件

# 3. 解决冲突
# → 选择版本或手动编辑

# 4. Stage 已解决的文件
s

# 5. 继续 rebase
c

# 6. 完成

# Go 版本问题
go version  # 确保 Go 1.18+

# 权限问题
sudo chown -R $(whoami) /usr/local/bin

# PATH 问题
echo 'export PATH="$PATH:~/go/bin"' >> ~/.zshrc

# Git 仓库外运行
cd my-git-repo
lazygit

# 使用指定仓库
lazygit --path /path/to/repo

# 使用指定配置文件
lazygit --config /path/to/config.yml

# 大仓库优化
# 在配置文件中添加
git:
  paging:
    color: always
  skipHookReload: true