
Lazygit 快速上手完整指南:如何 5 分钟装好这款 Git 终端图形化操作工具【免费下载链接】lazygitsimple terminal UI for git commands项目地址: https://gitcode.com/GitHub_Trending/la/lazygit想在终端里交互式 rebase,却要手动打开一个 todo 文件逐行改?想只暂存某个文件的几行改动,却得在命令行里逐 hunk 地抠?这些正是 Git 命令行的真实痛点。Lazygit 就是为此而生的开源工具——一个 simple terminal UI for git commands,把暂存、提交、rebase、cherry-pick 这些繁琐操作变成列表 按键的终端 Git 图形化界面(TUI),对新手极其友好。项目速览:30 秒认识 Lazygit项目定位:极简的终端 Git 客户端,覆盖暂存(可按行选择)、提交、分支、交互式 rebase、cherry-pick、bisect、worktree、undo 等日常操作,开箱即用主要编程语言:Go 语言,单一二进制、无运行时依赖,装完即用核心技术栈:gocui终端 UI 框架(项目内置的 fork,源码位于pkg/gocui/目录)gdamore/tcell负责终端渲染,creack/pty负责伪终端界面状态与按键绑定逻辑集中在pkg/gui/目录,git 命令封装在pkg/commands/git_commands/关键依赖:本地必须安装git可执行文件,所有实际操作最终都下发给 git;从源码编译则要求 Go 1.25.0 及以上(见根目录go.mod声明)环境准备清单:安装前自查表检查项是否必须说明Git必须lazygit 只是图形化外壳,底层全部调用本机 git,建议先执行git --version确认现代终端推荐Windows Terminal、iTerm2 等对配色和鼠标事件支持更好,体验最佳Go 1.25.0仅源码编译需要用包管理器或go install安装预编译二进制时无需关心包管理器按安装方式Homebrew / winget / Scoop / Chocolatey / pacman / apt 任选其一即可安装 Lazygit:推荐方式与多平台路径推荐安装方式:一条命令装好(适用平台:macOS、Linux)如果你已经装了 Homebrew(Linux 上同样可用),这是最快的一条命令:brew install lazygit安装完立即验证:lazygit --version用 Go 安装(适用平台:全平台,适合已有 Go 环境的开发者)go install github.com/jesseduffield/lazygitlatest编译产物会落在~/go/bin(Windows 为%USERPROFILE%\go\bin)。如果提示找不到命令,把该目录加入PATH后重开终端即可。Windows 安装 Lazygit 的三种方式(适用平台:Windows 10/11)任选其一:# 方式一:winget(系统自带,首选) winget install -e --idJesseDuffield.lazygit# 方式二:Scoop(需先加入 extras 桶) scoop bucket add extras scoop install lazygit# 方式三:Chocolatey choco install lazygit用发行版包管理器安装(适用平台:主流 Linux 发行版)# Arch Linux sudo pacman -S lazygit # Debian 13 / Ubuntu 25.10 等较新版本的官方源 sudo apt install lazygit较老的 Debian/Ubuntu 版本源里可能没有该包,建议走上面的brew或 Go 安装方式,或手动下载官方发布的二进制文件放入/usr/local/bin。从源码编译 Lazygit(适用场景:想跟进最新开发版本或贡献代码)需要本地已安装 Go 1.25.0:git clone https://gitcode.com/GitHub_Trending/la/lazygit cd lazygit go install也可以不安装,直接go run main.go编译并运行,适合快速尝鲜。首次运行与基础配置启动 Lazygit 的第一步进入任意一个 git 仓库目录,直接输入:lazygit界面启动后按?查看当前视图的按键提示,q退出。建议顺手加个别名,以后敲lg即可:echo alias lglazygit ~/.zshrc配置文件在哪里默认无需任何配置即可使用。想自定义时,全局配置文件位置如下:Linux:~/.config/lazygit/config.ymlmacOS:~/Library/Application Support/lazygit/config.ymlWindows:%LOCALAPPDATA%\lazygit\config.yml此外,单个仓库可以在仓库/.git/lazygit.yml里放局部配置,优先级高于全局配置,适合团队协作统一偏好。配置文件是 YAML 格式,官方完整说明在docs/Config.md,按键绑定参考docs/keybindings/目录下的多语言文档。新手最实用的 3 个配置项只把你真正想改的项写进配置文件即可(不要整份复制默认配置)。一份典型示例:gui: language: zh-CN # 界面语言,支持 zh-CN、zh-TW、ja、ko 等 scrollOffBehavior: jump # 列表滚动到底部后的行为:jump 为半页跳转,默认 margin 为平滑跟行 showFileTree: true # 文件视图用树状展示;设为 false 则是扁平列表language: zh-CN—— 中文界面,对新手最直观scrollOffBehavior—— 控制长列表滚动手感,可按习惯二选一showFileTree—— 文件多的大仓库里,树状结构更容易定位文件颜色主题、滚动高度、警告开关等更多选项见docs/Config.md中的默认配置参考;配色与主题逻辑源码位于pkg/theme/与pkg/gui/style/。常见问题排查1. 提示lazygit: command not found或命令未定义最常见原因是 PATH 没生效:go install的产物在~/go/bin(Windows 为%USERPROFILE%\go\bin),winget/Scoop 安装后需要重开终端。确认目录已在PATH中,再执行lazygit --version验证。2. 打开后看不到仓库内容,或提示不在 git 仓库中lazygit 需要在你所处的目录是一个 git 仓库(或能从上级目录找到仓库)时才显示其内容。先cd进仓库目录再启动;也可以启动后用侧边栏切换/打开其他仓库。3. 配置文件改了却不生效九成是路径写错了——三个平台的默认路径各不相同(见上文),尤其是 macOS 并不在~/.config下。另外配置建议只写入要覆盖的字段,写错层级或缩进时,程序会忽略无效项而继续使用默认值。4. 终端里鼠标选不动文字默认gui.mouseEvents: true会捕获鼠标用于交互,macOS 上需按住 Option 键才能选中文字。若你更习惯直接复制,可把该项设为false。一句话行动收尾现在,cd进你最常用的那个 git 仓库,敲下lazygit——5 分钟后你会发现,那些曾经劝退你的 git 命令,全都变成了列表上的一个按键。【免费下载链接】lazygitsimple terminal UI for git commands项目地址: https://gitcode.com/GitHub_Trending/la/lazygit创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考