跳至内容
GitTree
在 Linux 上 Git阅读 4 分钟

如何在 Ubuntu、Debian、Fedora 和 Arch 上安装并使用 git gui 与 gitk

git gui 是 Git 自带的提交工具,gitk 是配套的历史查看器。在 Linux 上它们各自位于单独的软件包中。本文给出各发行版的安装命令、两个窗口的使用方法、常见报错,以及它们做不到的事。

撰写者 Kodmora

GitTree 背后的软件公司

已更新
  • Linux
  • Git 图形用户界面客户端
  • Git 基础知识
GitTree 中的暂存更改:与 Stage Hunk 按钮和文件列表旁边的每行复选框的差异
GitTree
在 Linux 上 GitLinux 上的 git gui 与 gitk
在此页面上

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 gui

git gui 和 gitk 是什么,它们如何分工

Git 手册把 git gui 描述为一个通过新建提交、修改已有提交(amend)、创建分支、本地合并以及获取和推送来修改仓库的工具。它有意不显示历史:那是 gitk 的工作,git gui 会从 Repository 菜单打开 gitk。两者都能在 macOS、Windows 和 Linux 上运行;在 Linux 上它们就是典型的 Tk 应用,使用自己的字体,也没有与桌面匹配的深色主题。

git gui 与 gitk 一览(Ubuntu 24.04 中随 Git 2.43 提供的 git-gui 0.21)
工具用途启动方式做不到的事
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。以下命令已在各发行版的官方软件包页面核对:

各发行版安装 git gui 与 gitk 的命令(2026 年 11 月)
发行版命令说明
Ubuntu 22.04 和 24.04、Linux Mint、Pop!_OSsudo apt install git-gui gitk会自动安装 tk
Debian 12 及以后sudo apt install git-gui gitk与 Ubuntu 相同的软件包
Fedorasudo dnf install git-gui gitk两者都是 Fedora git 的子软件包
Arch Linux 和 Manjarosudo pacman -S git tkgit 软件包已包含两个工具;tk 只是可选依赖

安装后运行 git gui version 会显示 git-gui 的版本(Ubuntu 24.04 上为 0.21)。如果 Git 本身对其他工具来说太旧,可以按我们的在 Ubuntu 22.04 上升级 Git指南添加 git-core PPA,之后重新安装 git-gui,让两者版本保持一致。

在仓库中打开 git gui 的步骤

  1. 在项目文件夹中打开终端

    用 cd 进入仓库,或在文件管理器中右键点击该文件夹并在此打开终端。

  2. 运行 git gui

    输入 git gui 并按 Enter。窗口会针对该仓库打开:左上方是 Unstaged Changes,下方是 Staged Changes (Will Commit),右侧是差异,底部是提交信息框。

  3. 或在启动窗口中选择仓库

    在仓库外启动时,git gui 会提供三个选项:Create New Repository、Clone Existing Repository 和 Open Existing Repository,并列出最近使用的仓库。

  4. 常用的话放到桌面上

    打开仓库后,选择 Repository › Create Desktop Icon 会创建一个启动器,一键就能在该仓库中打开 git gui。

用 git gui 提交

  1. 在其他程序里编辑文件后,用 Rescan(F5)刷新列表。
  2. 点击 Unstaged Changes 中文件的图标即可暂存,也可以使用 Commit › Stage To Commit(Ctrl+T)。Stage Changed 会暂存所有已修改的受跟踪文件。
  3. 只想提交文件的一部分时,在差异中右键选择 Stage Hunk For Commit,或选中若干行后选择 Stage Lines For Commit。
  4. 在提交框中输入信息。Sign Off 会添加你的 Signed-off-by 行,Amend Last Commit 选项会重新打开上一个提交,而不是新建提交。
  5. 按 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 中对比(我们并不中立,请自行核实每一项):

Linux 上的日常 Git 任务:git gui 与 gitk 对比 GitTree
任务git gui 与 gitkGitTree
暂存文件、代码块和单独的行可以可以
在同一个窗口查看历史和提交不行:历史在单独的 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
GitTree 主窗口:1 仓库标签页,2 带有撤销、拉取、推送、分支和储藏的工具栏,3 分支、远程和储藏的侧边栏,4 提交图,5 所选提交,6 状态栏。
GitTree 主窗口:1 仓库标签页,2 带有撤销、拉取、推送、分支和储藏的工具栏,3 分支、远程和储藏的侧边栏,4 提交图,5 所选提交,6 状态栏。GitTree 与演示存储库的接口。
在 GitTree 中逐行暂存,与 git gui 的 Stage Lines For Commit 思路相同,差异和文件列表并排显示。
在 GitTree 中逐行暂存,与 git gui 的 Stage Lines For Commit 思路相同,差异和文件列表并排显示。GitTree 与演示存储库的接口。
  • 提交图与提交在一起。 提交图是主视图,顶部的 // 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日 的官方页面进行了检查。价格和功能发生变化;供应商的页面是事实的来源。