gitbutlerapp/gitbutler - 项目详情

项目介绍快速开始学习路径项目截图 2 贡献者 121 增长趋势代码统计生态关系项目时间线项目竞品依赖分析上榜历史

5分钟上手 GitButler

通过本指南，你将快速安装并启动 GitButler，体验其现代化的 Git 版本控制界面

环境要求

支持的操作系统

macOS Windows Linux

所需工具

Git

GitButler 基于 Git 构建，需要 Git 环境

必需

操作步骤

下载安装包

根据你的操作系统，从 GitButler 官网下载对应的安装包

前往官网下载页面

打开浏览器访问：https://gitbutler.com

预期结果：看到下载页面，选择适合你操作系统的版本（macOS .dmg、Windows .exe、Linux .AppImage）

如果官网下载慢，可以查看 GitHub Releases 页面获取其他下载方式

安装应用程序

运行下载的安装包完成安装

不同系统的安装方式

macOS: 双击 .dmg 文件，将 GitButler 拖到 Applications 文件夹
Windows: 双击 .exe 安装程序
Linux: 给 .AppImage 文件添加执行权限：chmod +x GitButler-*.AppImage

预期结果：在应用程序列表或开始菜单中看到 GitButler 图标

Linux 用户也可以使用包管理器安装，具体参考官网文档

启动 GitButler

打开 GitButler 应用程序

启动应用程序

macOS: 从 Applications 文件夹打开
Windows: 从开始菜单打开
Linux: 双击 .AppImage 文件或从应用菜单打开

预期结果：看到 GitButler 欢迎界面或主界面

首次启动可能需要一些时间初始化

打开现有 Git 仓库

GitButler 可以立即在任何现有的 Git 仓库中使用

选择你的本地 Git 仓库文件夹

点击 "Open Repository" 或 "Add Repository" 按钮

预期结果：看到你的仓库文件列表和提交历史

如果没有现成仓库，可以创建一个新文件夹并用 `git init` 初始化

验证成功

成功启动 GitButler 并看到你的 Git 仓库内容

GitButler 主界面正常显示

能看到仓库的文件列表

能看到提交历史记录

界面左侧有分支管理面板

快速提示

配置

GitButler 会自动检测你系统上的 Git 仓库，可以在设置中配置扫描路径

性能

使用 Cmd/Ctrl + K 快速打开命令面板，执行各种 Git 操作

其他

右键点击提交可以轻松进行修改、拆分、压缩等操作，无需复杂的 rebase 命令

常见问题

启动时提示 Git 未安装或版本过低

确保已安装 Git 且版本较新，可以从 https://git-scm.com 下载最新版

无法打开某些 Git 仓库

检查仓库权限，确保你有读取权限。大型仓库首次加载可能需要一些时间

界面显示异常或空白

尝试重启应用，或检查系统图形驱动是否正常

下一步

尝试创建堆叠分支

体验 GitButler 的核心功能：创建基于其他分支的堆叠分支

连接 GitHub/GitLab

在设置中配置 Forge 集成，管理 Pull Request 和 CI 状态

安装 CLI 工具

从官网下载 but CLI，在终端中使用 GitButler 的强大功能