如何在 Ubuntu、Debian、Fedora 和 Arch 上安装并使用 git gui 与 gitk
git gui 是 Git 自带的提交工具,gitk 是配套的历史查看器。在 Linux 上它们各自位于单独的软件包中。本文给出各发行版的安装命令、两个窗口的使用方法、常见报错,以及它们做不到的事。
撰写者 Kodmora
GitTree 背后的软件公司
- Linux
- Git 图形用户界面客户端
- Git 基础知识

在此页面上
git gui 是 Git 自带的图形化提交工具,gitk 是与之配套的历史查看器。两者都是用 Tcl/Tk 编写的小程序:git gui 负责暂存更改、编写提交、创建分支、合并和推送;gitk 负责绘制提交图。在 Ubuntu、Debian 和 Linux Mint 上,它们不在 git 软件包里,所以刚装好 Git 就输入 git gui 会看到 git: 'gui' is not a git command。先安装它们,再在仓库目录中启动 git gui:
sudo apt install git-gui gitk
cd ~/code/my-project
git guigit gui 和 gitk 是什么,它们如何分工
Git 手册把 git gui 描述为一个通过新建提交、修改已有提交(amend)、创建分支、本地合并以及获取和推送来修改仓库的工具。它有意不显示历史:那是 gitk 的工作,git gui 会从 Repository 菜单打开 gitk。两者都能在 macOS、Windows 和 Linux 上运行;在 Linux 上它们就是典型的 Tk 应用,使用自己的字体,也没有与桌面匹配的深色主题。
| 工具 | 用途 | 启动方式 | 做不到的事 |
|---|---|---|---|
| git gui | 暂存文件、代码块和行;编写、修改和签署提交;分支;本地合并;获取和推送 | 在仓库中运行 git gui | 显示历史、一步拉取、储藏、变基 |
| gitk | 浏览提交图、搜索提交、查看每个提交的差异 | gitk 或 gitk --all | 提交、暂存或推送 |
| git citool | 只做一次提交然后关闭 | git citool(或 git citool --amend) | 提交之后的任何操作 |
| git gui blame | 逐行标注文件,并显示每行来自哪个提交 | git gui blame <file> | 编辑文件 |
| git gui browser | 浏览某个分支或提交中的文件 | git gui browser <branch> | 修改文件 |
在 Ubuntu、Debian、Mint、Fedora 和 Arch 上安装 git gui 与 gitk
各发行版把 Git 拆成命令行软件包和单独的图形界面软件包,所以只装 Git 时窗口工具不会被装上。软件包版本跟随你的 Git:Ubuntu 24.04 会在 Git 2.43.0 旁安装 git-gui 1:2.43.0。以下命令已在各发行版的官方软件包页面核对:
| 发行版 | 命令 | 说明 |
|---|---|---|
| Ubuntu 22.04 和 24.04、Linux Mint、Pop!_OS | sudo apt install git-gui gitk | 会自动安装 tk |
| Debian 12 及以后 | sudo apt install git-gui gitk | 与 Ubuntu 相同的软件包 |
| Fedora | sudo dnf install git-gui gitk | 两者都是 Fedora git 的子软件包 |
| Arch Linux 和 Manjaro | sudo pacman -S git tk | git 软件包已包含两个工具;tk 只是可选依赖 |
安装后运行 git gui version 会显示 git-gui 的版本(Ubuntu 24.04 上为 0.21)。如果 Git 本身对其他工具来说太旧,可以按我们的在 Ubuntu 22.04 上升级 Git指南添加 git-core PPA,之后重新安装 git-gui,让两者版本保持一致。
在仓库中打开 git gui 的步骤
在项目文件夹中打开终端
用
cd进入仓库,或在文件管理器中右键点击该文件夹并在此打开终端。运行 git gui
输入
git gui并按 Enter。窗口会针对该仓库打开:左上方是 Unstaged Changes,下方是 Staged Changes (Will Commit),右侧是差异,底部是提交信息框。或在启动窗口中选择仓库
在仓库外启动时,git gui 会提供三个选项:Create New Repository、Clone Existing Repository 和 Open Existing Repository,并列出最近使用的仓库。
常用的话放到桌面上
打开仓库后,选择 Repository › Create Desktop Icon 会创建一个启动器,一键就能在该仓库中打开 git gui。
用 git gui 提交
- 在其他程序里编辑文件后,用 Rescan(F5)刷新列表。
- 点击 Unstaged Changes 中文件的图标即可暂存,也可以使用 Commit › Stage To Commit(Ctrl+T)。Stage Changed 会暂存所有已修改的受跟踪文件。
- 只想提交文件的一部分时,在差异中右键选择 Stage Hunk For Commit,或选中若干行后选择 Stage Lines For Commit。
- 在提交框中输入信息。Sign Off 会添加你的
Signed-off-by行,Amend Last Commit 选项会重新打开上一个提交,而不是新建提交。 - 按 Commit(Ctrl+Enter),再按 Push 把分支推送到远程。
用 gitk 浏览历史
gitk 会打开一个三窗格窗口:上方是带有信息、作者和日期的提交图,左下是所选提交的差异,右下是它修改的文件。单独运行 gitk 显示当前分支,gitk --all 显示所有分支和标签。在 git gui 中,Repository › Visualize Current Branch’s History 和 Visualize All Branch History 会打开相同的视图。值得记住的几条命令:
gitk --all
gitk -- src/main.c
git gui blame src/main.c
git gui browser main
git citool --amend依次是:所有分支、只看涉及某个文件的提交、逐行 blame、main 分支的文件浏览器,以及一个修改上一个提交的一次性窗口。在 gitk 中,提交图下方的搜索框可以按信息、作者或修改过的路径查找提交。
解决 Linux 上 git gui 与 gitk 的常见报错
git: 'gui' is not a git command
缺少 git-gui 软件包。请用上表中对应发行版的命令安装。另一个相关的误区:git-gui 程序位于 Git 自己的目录(Ubuntu 上是 /usr/lib/git-core),不在 PATH 中,所以要输入带空格的 git gui。
gitk: exec: wish: not found
gitk 是一个由 Tk 的 shell wish 运行的脚本。在 Arch Linux 和 Manjaro 上,git 软件包安装 gitk 时不带 Tk,所以需要安装 tk。在其他发行版上,重新安装 gitk 软件包即可恢复 Tk。
no display name and no $DISPLAY environment variable
git gui 和 gitk 需要图形会话。通过普通 SSH 连接、在容器中或在没有桌面的终端里,都会出现这条信息。请在本机桌面上运行它们,或用 ssh -X 连接,让窗口显示在你的屏幕上。
在高分辨率屏幕上文字太小
打开 Edit › Options…,调大 Main Font 和 Diff/Console Font。在 Global (All Repositories) 一列中修改,设置会作用于所有仓库。
git gui 和 gitk 做不到的事
git gui 多年来几乎没有变化,对于它原本设计的提交工作来说已经够用。但只要你的日常不止提交和推送,不足就会显现。下面把同样的任务放在 git gui、gitk 和我们开发的 Git 客户端 GitTree 中对比(我们并不中立,请自行核实每一项):
| 任务 | git gui 与 gitk | GitTree |
|---|---|---|
| 暂存文件、代码块和单独的行 | 可以 | 可以 |
| 在同一个窗口查看历史和提交 | 不行:历史在单独的 gitk 窗口中 | 可以:提交图就是主视图 |
| 拉取 | 先获取,再做本地合并 | 一个按钮,可选快进、合并或变基 |
| 储藏 | 不行 | 可以,支持应用和弹出 |
| 交互式变基(调整顺序、squash、改写信息) | 不行 | 可以,在编辑器中完成 |
| 合并冲突 | 选择整个一侧,或启动外部合并工具 | 三方冲突编辑器,逐行处理 |
| 撤销 reset、变基或已删除的分支 | 不行 | 可以:撤销与重做,以及 Lost & Found |
| 拉取请求和 CI/CD 运行 | 不行 | 可以,需 GitTree Pro |
| SSH 密钥 | Help › Show SSH Key 显示或生成一个密钥 | 偏好设置 › SSH 可生成密钥、为远程选择密钥并测试连接 |
Linux 上的现代替代方案:一切都在一个窗口里
如果你喜欢 git gui 的逐行暂存,却缺少其余功能,GitTree 保留了这个习惯并补齐了其他部分。它是一款适用于 macOS、Windows 和 Linux 的桌面 Git 客户端,运行在你已安装的 Git 之上,提供面向 Ubuntu 22.04+ 和 Debian 12+ 的 .deb 以及 AppImage,免费版(Free)包含所有 Git 功能,私有仓库和工作用途也不例外。在 Ubuntu、Debian 或 Linux Mint 上,一条命令即可安装:
curl -fsSL https://gittree.app/install.sh | bash

- 提交图与提交在一起。 提交图是主视图,顶部的
// WIP行打开你的更改,无需切换到第二个窗口。详见我们的 Git 树可视化指南。 - 安全网。 在 reset、变基、丢弃更改或删除分支之前,GitTree 会先拍摄快照,因此 撤销 可以还原操作。
- 就地解决冲突。 三方编辑器显示两侧和结果;参见解决合并冲突。
- 改写历史。 在交互式变基编辑器中调整顺序、合并、改写或删除提交。
- 密钥留在本地。 SSH 密钥保留在
~/.ssh,令牌只保存在 Secret Service(GNOME Keyring 或 KeePassXC)中。
想比较更多选择?我们的 Linux 最佳 Git GUI 并排比较了七款客户端,Git GUI 与命令行对比帮你判断何时窗口胜过终端,Linux 安装指南介绍了 .deb、AppImage 和卸载方法。
常见问题
Ubuntu 上的 Git 自带 git gui 吗?
不自带。Ubuntu 和 Debian 把 git gui 和 gitk 放在单独的软件包 git-gui 与 gitk 中,所以只运行 sudo apt install git 不会安装它们。请用 sudo apt install git-gui gitk 安装,apt 会一并加上两者都需要的 Tk。
怎么打开 git gui?
在仓库中打开终端并运行 git gui(中间有空格)。在仓库外运行时,会出现用于新建、克隆或打开仓库的启动窗口。在 git gui 中,Repository › Create Desktop Icon 可以为该仓库添加启动器。
git gui 和 gitk 有什么区别?
git gui 用于创建提交:暂存、写提交信息、修改提交、创建分支、本地合并、获取和推送。gitk 是历史浏览器,绘制提交图并显示每个提交的差异。git gui 可以从 Repository 菜单打开 gitk。
为什么 Linux 提示 gui 不是 git 命令?
因为没有安装 git-gui 软件包。在 Ubuntu、Debian 和 Mint 上运行 sudo apt install git-gui,在 Fedora 上运行 sudo dnf install git-gui;在 Arch 上 git 软件包已经包含它,但需要 sudo pacman -S tk 才能启动。
git gui 能储藏、变基或撤销吗?
不能。git gui 没有储藏,没有普通或交互式变基,也没有通用撤销;Undo Last Revert 只能恢复最近一次还原的代码块或行。这些操作请使用命令行,或使用像 GitTree 这样在窗口中提供它们的客户端。
gitk 能在 Wayland 上运行吗?
能,通过 XWayland 运行,这是 GNOME 和 KDE Plasma 为旧应用启动的 X11 兼容层。Tk 以 X11 客户端的方式绘制窗口,所以外观与原生应用略有不同。要放大文字,在 gitk 中使用 Edit › Preferences,在 git gui 中使用 Edit › Options…。
Linux 上有比 git gui 更好的 Git GUI 吗?
取决于你缺什么。GitTree 保留了逐行暂存,并增加了提交图、储藏、交互式变基、冲突编辑器和撤销,所有 Git 功能都在免费版中。我们的 Linux 最佳 Git GUI 比较了包括开源工具在内的七款客户端。
来源
有关其他产品的声明已根据其位于 2026年11月19日 的官方页面进行了检查。价格和功能发生变化;供应商的页面是事实的来源。