# GitButler

一款 macOS Git 客户端，可在现有工作流程中同时处理多个分支。

> 这是 OpenNavo 上 GitButler 页面的 Markdown 版本，内容与网页相同： <https://opennavo.com/zh/apps/gitbutler>

- **最新版本**: `0.23.5,3373`
- **开发者**: GitButler Inc
- **主页**: <https://gitbutler.com/>
- **分类**: [开发工具](https://opennavo.com/zh/categories/developer-tools)
- **安装**: `brew install --cask gitbutler`
- **近 30 天安装**: 373
- **Homebrew**: 可以安装，应用会自行更新
- **下载地址**: <https://releases.gitbutler.com/releases/release/0.23.5-3373/macos/aarch64/GitButler.app.tar.gz>
- **SHA-256**: `783a91ef5da43e28fab6b672bf9e65d0d49e9671489daaac9646c5429d9122f4`
- **附带命令**: but

SHA-256 只用来核对下载的文件是否完整，不代表安全认证。

## 安装与卸载内容

```json
[
  {
    "declaration": {
      "app": [
        "GitButler.app"
      ],
      "target": "/Applications/GitButler.app"
    },
    "phase": "install",
    "sources": [
      "GitButler.app"
    ],
    "target": "/Applications/GitButler.app",
    "type": "app"
  },
  {
    "declaration": {
      "binary": [
        "$APPDIR/GitButler.app/Contents/MacOS/gitbutler-tauri",
        {
          "target": "but"
        }
      ],
      "target": "$HOMEBREW_PREFIX/bin/but"
    },
    "phase": "install",
    "sources": [
      "$APPDIR/GitButler.app/Contents/MacOS/gitbutler-tauri"
    ],
    "target": "$HOMEBREW_PREFIX/bin/but",
    "type": "binary"
  },
  {
    "declaration": {
      "zap": [
        {
          "trash": [
            "~/Library/Application Support/com.gitbutler.app",
            "~/Library/Application Support/gitbutler",
            "~/Library/Caches/com.gitbutler.app",
            "~/Library/Logs/com.gitbutler.app",
            "~/Library/Preferences/com.gitbutler.app.plist",
            "~/Library/Saved Application State/com.gitbutler.app.savedState",
            "~/Library/WebKit/com.gitbutler.app"
          ]
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## 介绍

GitButler 是一款 Git 客户端，可在现有工作流程中同时处理多个分支。其 Homebrew cask 会将 `GitButler.app` 安装到 `/Applications`，并在 Homebrew 的二进制文件目录中提供 `but` 命令行可执行文件。

使用 Homebrew 安装时，请运行 `brew install --cask gitbutler`。安装后可从“应用程序”文件夹打开 GitButler。

来源：[GitButler](https://gitbutler.com/) · [Homebrew cask](https://raw.githubusercontent.com/Homebrew/homebrew-cask/HEAD/Casks/g/gitbutler.rb)

## 系统要求

- 适用于 macOS 27, 26, 15, 14, 13, 12, 11 的版本 · 应用版本: 0.23.5,3373 · Intel · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/g/gitbutler.rb> · 核查于 2026-11-22
  - <https://releases.gitbutler.com/releases/release/0.23.5-3373/macos/x86_64/GitButler.app.tar.gz>
  - SHA-256: `9236906a74ebc14ddc0a1b04bf86c2873eaba1abe5b7d94a5c8d1bea439e95e4`
- 适用于 macOS 27, 26, 15, 14, 13, 12, 11 的版本 · 应用版本: 0.23.5,3373 · Apple 芯片 · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/g/gitbutler.rb> · 核查于 2026-11-22
  - <https://releases.gitbutler.com/releases/release/0.23.5-3373/macos/aarch64/GitButler.app.tar.gz>
  - SHA-256: `783a91ef5da43e28fab6b672bf9e65d0d49e9671489daaac9646c5429d9122f4`

## 卸载

- `brew uninstall --cask gitbutler`

普通卸载会删除应用本身，设置和缓存会保留。

### 深度清理（可选）

- `brew uninstall --zap --cask gitbutler`

`--zap` 还会删除 Homebrew 定义里列出的设置、缓存等文件，其中可能有其他应用共用的数据，删除后无法恢复；它也不保证没有任何残留。请先备份需要保留的数据；如要保留设置和缓存，请不要加 `--zap`。

普通卸载会删除应用本身，设置和缓存会保留。

- 文件和文件夹: `~/Library/Application Support/com.gitbutler.app` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/g/gitbutler.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/Application Support/gitbutler` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/g/gitbutler.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/Caches/com.gitbutler.app` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/g/gitbutler.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/Logs/com.gitbutler.app` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/g/gitbutler.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/Preferences/com.gitbutler.app.plist` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/g/gitbutler.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/Saved Application State/com.gitbutler.app.savedState` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/g/gitbutler.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/WebKit/com.gitbutler.app` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/g/gitbutler.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。

## 最新版本说明

### 0.23.5 (2026-11-20)

GitButler 0.23.5 于 2026 年 11 月 20 日发布，修复同时处理多条分支的人在 Windows 上再次修改提交，以及推送剩余栈时失败的问题。

GitButler 0.23.5 为在现有 Git 流程上同时推进多条分支的人，修复分支、栈和 Windows 上的提交操作。发布于 2026 年 11 月 20 日。来源：https://github.com/gitbutlerapp/gitbutler/releases/tag/release/0.23.5

- Linux 上线经过验证的 Flathub 包，包含原生应用。
- 修复 Windows 上对同一次提交的第二次 amend、改写说明或移入，这是 0.23.3 的回归，报错为 "Failed to find commit … in rebase editor"。
- 让 Windows 上提交的符号链接在 Linux 和 macOS 上可用。
- 修复栈里几条分支合并后继续推送其余部分，此前报错 "There are no new commits between base branch …"。
- 删除最后一条已应用的分支时，即使 main 已经前进，也不再让 HEAD 脱离。
- 加载远落后于上游的大项目时，不再占用数 GB 内存。
- 新增 `but worktree recycle`，复用一个干净的已归档工作树，并保留其中的构建产物。
- 原生应用可为浅色和深色分别选主题，更新或崩溃后回到上次的位置，把分支拖到两个栈之间会让它自成一栈。

## 资料与来源

- <https://opennavo.com/zh/apps/gitbutler>
- <https://opennavo.com/zh/apps/gitbutler/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/g/gitbutler.rb> · 核查于 2026-11-22
- <https://formulae.brew.sh/cask/gitbutler>
