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。不在倉庫裡會失敗。遠端要已設定 origin 才能推送。

  3. 3

    在 Files 面板用空白鍵暫存

    預設焦點在 Files。方向鍵選檔，Space 切換暫存；a 暫存全部（以 ? 核對）。左側能看到 staged / unstaged。

  4. 4

    按 c 寫提交說明

    暫存後按 c 打開提交框。需要完整編輯器時用大寫 C。空暫存區時提交會被拒絕。

  5. 5

    按 P 推送到遠端

    按 P 推送目前分支。首次可能詢問 upstream。憑證走本機 Git：SSH key、gh auth 或 credential helper。

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。Enter 進入 hunk，可按塊暫存。

02

Branches 與 Commits

切到 Branches 检出或建分支。Commits 可改最近說明。破壞性操作前會確認。

03

自訂設定

常見路徑 ~/.config/lazygit/config.yml。先用預設鍵跑通，再改主題。

常見坑

啟動失敗：目前目錄不是倉庫，或 PATH 沒有 git。推送被拒：沒有 origin、沒有 upstream、或憑證過期。快捷鍵對不上：終端吃掉 Ctrl，或改過 config；按 ? 查看。

提交推完、要攤草圖時，回 wbstorm 用房間號即可，另見 建立或加入房間 和 白板基礎。編輯器規則見 如何寫 Cursor Rules。

必須用 Homebrew 嗎？

不必。README 列出各平台套件、Go 安裝與二進位。選本機已有的渠道即可。

lazygit 會取代 git 嗎？

不會。它只是 TUI，底層仍執行 git。倉庫、鉤子、憑證都還在 Git。

和 GitHub Desktop 有何不同？

Desktop 是圖形客戶端。lazygit 留在終端，適合 SSH 組合與分屏編輯器。

這是 wbstorm 的功能嗎？

不是。本文只講 lazygit。wbstorm 是瀏覽器腦力激盪房間，和 Git 客戶端無關。

建立房間