wbstorm

如何安装并使用 lazygit：在 TUI 里暂存、提交并推送

安装 lazygit，在仓库打开 TUI，空格暂存、c 提交、P 推送到 origin。

终端里敲一长串 git add、git commit、git push 容易漏文件。lazygit 是 Jesse Duffield 维护的终端 Git 界面：在仓库目录运行 lazygit，用键盘暂存、提交、推送。

对照 GitHub 仓库 jesseduffield/lazygit 的安装说明，完成本机 安装并使用 lazygit：打开仓库、空格暂存、c 提交、P 推送。这是开发者工具教程，不是头脑风暴说明书。

安装打开仓库暂存 / 提交 / 推送

先装好 Git 再装 TUI

lazygit 调用本机 git，不会替代 Git。macOS 常用 Homebrew；Linux 看发行版包或 GitHub Releases；Windows 可用 Scoop、Chocolatey 或 WinGet。官方列表在仓库 README 的 Installation。

TUI
终端界面
Space
暂存当前文件
c / P
提交 / 推送
方式前提适合谁
HomebrewmacOS / Linuxbrew一条 brew install lazygit
发行版包 / ReleasesLinux仓库包过旧时下官方二进制
Scoop / Choco / WinGetWindows不想自己解压 zip

五步完成第一次推送

  1. 1

    安装 lazygit

    macOS：brew install lazygit。确认 lazygit --version 有输出版本。命令以 README 为准，包名偶尔会变。

  2. 2

    在 Git 仓库里启动

    cd 到已 git init 或已 clone 的目录，执行 lazygit。不在仓库里会报错或提示不是 git 目录。远程要已配置 origin 才能推送。

  3. 3

    在 Files 面板用空格暂存

    默认焦点在 Files。方向键选文件，Space 切换暂存；a 暂存全部（以当前版本快捷键为准，按 ? 核对）。左侧能看到 staged / unstaged。

  4. 4

    按 c 写提交说明

    暂存后按 c 打开提交框，写一行说明后确认。需要完整编辑器时用大写 C（走 GIT_EDITOR）。空暂存区时提交会被拒绝。

  5. 5

    按 P 推送到远程

    按 P（大写）推送当前分支。首次可能询问 upstream。凭据走本机 Git：SSH key、gh auth 或 credential helper，lazygit 不另开一套登录。

brew install lazygit
# Ubuntu/Debian (see GitHub Releases if the repo package is old):
# sudo apt install lazygit

cd /path/to/your/repo
lazygit
# Space = stage  ·  c = commit  ·  P = push  ·  ? = keys

界面里先认这三块

01

Files 与 diff

选中文件后右侧或下方是 diff。回车进入文件 hunk，可按块暂存，不必整文件一次加进去。

02

Branches 与 Commits

切到 Branches 检出或建分支。Commits 里能改最近说明、cherry-pick。破坏性操作前界面会确认。

03

自定义配置

配置文件路径见 README（常见为 ~/.config/lazygit/config.yml）。先用默认键跑通一遍，再改主题或自定义命令。

常见坑

启动失败：当前目录不是仓库，或 PATH 里没有 git。推送被拒：没有 origin、分支无 upstream、或 SSH/HTTPS 凭据过期。快捷键对不上：终端把 Ctrl 组合吞了，或自定义过 config；按 ? 看本机映射。

提交推完、要摊草图时，回 wbstorm 用房间号即可，另见 创建或加入房间 和 白板基础。编辑器规则见 如何写 Cursor Rules。

必须用 Homebrew 吗？

不必。README 列出各平台包管理器、Go 安装和二进制。选你本机已有的渠道即可。

lazygit 会替换 git 吗？

不会。它只是 TUI，底层仍执行 git。仓库、钩子、凭据都还在 Git 那一套。

和 GitHub Desktop 有何不同？

Desktop 是图形客户端。lazygit 留在终端，适合 SSH 会话和分屏编辑器。功能重叠在暂存、提交、分支，不是网页 PR 审阅器。

这是 wbstorm 的功能吗？

不是。本文只讲 lazygit 的安装与 TUI 提交推送。wbstorm 是浏览器头脑风暴房间，和 Git 客户端无关。

创建房间