如何从 GitKraken 迁移到 GitSquid:逐步指南
切换 Git 客户端令人头疼。你已经有了一套可用的配置 — 配置文件、集成、主题、键盘快捷键 — 不想从零开始。本指南将带你在大约 15 分钟内,在 GitSquid 中复刻你的 GitKraken 设置,并附上你最常用 Git 操作的功能映射表。
说明:本文发布于 GitSquid 网站。
开始之前
这里的任何操作都不会触及你的仓库。GitKraken 和 GitSquid 都是对 `.git` 目录只读 — 它们调用 Git 命令,并不拥有数据。你可以将两者并行安装,指向同一个仓库,并随时切回。
如果想做一次干净的对比,请安装 GitSquid 并使用一周,然后再卸载 GitKraken。这足以确认工作流是否站得住脚。
第 1 步:安装 GitSquid(2 分钟)
前往下载页面,获取适配你平台的构建:
- macOS — 原生 arm64(通过 Rosetta 在 Intel 上运行)。
- Windows — 原生 x64 或 ARM64(Snapdragon X / Surface Pro X)。
- Linux — x64 或 ARM64 的 AppImage。
无需创建账户。无遥测同意弹窗。打开应用即进入欢迎界面。
第 2 步:指向你已有的仓库(2 分钟)
在欢迎界面点击"打开仓库",选择和 GitKraken 中一样的文件夹。每个仓库都会像在 GitKraken 中一样在自己的标签页打开。Free 版同时支持 3 个标签页;Pro 提升至无限。
最近使用过的仓库会自动出现在欢迎界面 — 超过 5 个时还可以搜索。
第 3 步:重建你的配置文件(3 分钟)
如果你在 GitKraken 中使用了多个 Git 身份(工作邮箱、个人邮箱、开源身份),请在设置 → 配置文件中重新创建:
- 点击"创建配置文件"。
- 输入名称(例如"工作"或"Open source")。
- 将 Git 的 name 和 email 设置为与 GitKraken 完全相同。
- 如果你为提交签名,请把 GPG 密钥 ID 粘贴到 GPG 签名字段。
- 对每个身份重复此步骤。
Free 版支持 1 个配置文件;Pro 支持无限。GitSquid 中切换配置文件只需在标题栏点一下,与 GitKraken 是同一种模型。
第 4 步:连接你的 Git 托管平台(3 分钟)
在设置 → 集成中,连接每一个托管平台:
GitHub
- 点击 GitHub 旁的"连接"。
- 打开 github.com/settings/tokens,创建一个 fine-grained personal access token。授予 repo 与 pull request 范围。
- 粘贴回 GitSquid。集成通过调用 `/user` 进行验证。
GitLab
- 点击 GitLab 旁的"连接"。
- 打开 gitlab.com/-/profile/personal_access_tokens,创建一个带 `api` 范围的 personal access token。
- 粘贴到 GitSquid。
Bitbucket Cloud
- 点击 Bitbucket 旁的"连接"。
- Bitbucket 不再使用 app passwords。请在 id.atlassian.com/manage-profile/security/api-tokens 创建一个 Atlassian API token。
- 输入你的 Atlassian 邮箱与 API token。GitSquid 使用 email + token 进行 HTTP basic 认证,正是 Bitbucket Cloud 期望的格式。
连接后,你可以在 GitSquid 内直接列出 / 创建 / 评审各平台的 pull request、管理 issue、查看 CI 检查状态 — 与 GitKraken 同样的工作流。
Free 版支持 1 个集成;Pro 支持无限。
第 5 步:重建主题(1 分钟)
GitSquid 默认随附 6 个主题:Dark、Light、Midnight、Solarized Dark、Dracula、Nord。在设置 → 外观中选择其一。
如果你之前使用了自定义的 GitKraken 主题,GitSquid Pro 允许你在设置 → 主题中创建自己的主题:编辑每种颜色(background primary / secondary、accent、text、border)并保存。没有从 GitKraken 格式自动导入。
第 6 步:映射键盘快捷键(2 分钟)
GitSquid 的默认快捷键与 GitKraken 相似但并不完全相同:
| 动作 | GitKraken 默认 | GitSquid 默认 |
|---|---|---|
| 搜索提交 | Cmd/Ctrl+P | Cmd/Ctrl+F |
| 新建分支 | Cmd/Ctrl+B | Cmd/Ctrl+N |
| 提交(staging) | Cmd/Ctrl+Enter | Cmd/Ctrl+Enter |
| 切换终端 | 无 | Cmd/Ctrl+` |
| 切换命令日志 | 无 | Cmd/Ctrl+Shift+L |
| 键盘快捷键 | ? | F1 |
如果想重新映射任何快捷键以贴合你的 GitKraken 肌肉记忆,请前往设置 → 快捷键(Pro)。点击任意动作,按下新组合,保存。可一键重置单个快捷键或全部快捷键。
功能映射
| GitKraken 功能 | GitSquid 对应 |
|---|---|
| 提交图 | 相同,基于 canvas 渲染并支持 virtual scrolling |
| 暂存(文件 / hunk / 行) | 相同,新增拖放与文件夹级操作 |
| diff 查看器(unified / split / blame) | 相同,由 CodeMirror 驱动并支持完整语法高亮 |
| 合并冲突编辑器 | 相同的 3-way 编辑器,内置代码编辑器 |
| 交互式 rebase | 相同,支持拖放重排和按提交的操作 |
| Cherry-pick / revert / reset | 相同,包含多提交的 cherry-pick |
| stash 管理 | 相同,list / save / apply / pop / drop / clear all |
| 标签管理 | 相同,创建 / 删除 / 推送到远程 |
| Worktree | 相同,创建 / lock / unlock / 删除 / 在标签页打开 |
| Submodule | 相同,list / init / update |
| Gitflow | 相同,init + feature / release / hotfix start & finish |
| Git LFS | 相同,track patterns / pull / push / 状态面板 |
| reflog 查看器 | 相同,支持从 reflog 检出 |
| GPG 签名 | 相同,按配置文件设置 |
| Pull request / issue | GitHub / GitLab / Bitbucket 的相同流程 |
| AI 提交信息 | 支持(Claude Code、Anthropic、OpenAI、自定义) |
| AI explain | 新增 — 右键提交 / hunk / 文件即可获得流式解释 |
| AI PR 描述 | 新增 — 创建 PR 对话框中的"Generate with AI" |
| 冲突预测器 | 新增 — merge / rebase / cherry-pick 前预览冲突 |
| 预提交密钥扫描 | 新增 — 拦截 AWS / GitHub / OpenAI 密钥、JWT 等 |
| Branch intent | 新增 — 通过 git notes 附加到分支的 markdown 计划 |
| Monorepo 范围 | 新增 — 自动检测 npm / pnpm / Cargo / Nx workspace |
| 文件时间线滑块 | 新增 — 在任意文件历史上方拖动滑块 |
| 团队活动时间线 | 新增 — 按作者 × 周的热力图 |
| Jira 集成 | GitSquid 暂无 |
| Azure DevOps 集成 | GitSquid 暂无 |
| GitLens(VS Code) | 不适用 — GitSquid 仅为桌面客户端 |
| 云端配置文件 / 设置同步 | GitSquid 暂无 — 一切保留在本地 |
你将失去的
为了校准预期,GitKraken 中在 GitSquid 没有对应的功能:
- Jira / Azure DevOps 集成。如果你的团队依赖它们,GitSquid 在这一面不会取代 GitKraken。我们在公共 backlog 中跟踪这一项。
- 云端同步设置。GitKraken 通过你的 Atlassian 账户在多台机器间同步配置文件和设置。GitSquid 一切都保存在本地。如果你在多台机器上工作,目前需要在每台机器上重做第 3-6 步。
- 团队管理面板。GitKraken 有组织级管理功能。GitSquid 按个人席位授权。
如果其中任何一项对你的工作流至关重要,GitSquid 就不会是一个干净的迁移目标。
你将获得的
- 价格减半。49 EUR/年 vs 96 $/年。
- 无需账户。启动时无登录界面。
- 无遥测。没有任何数据离开你的机器。
- 支持 Linux。换机器时可使用 Linux x64 与 ARM64 的原生二进制。
- 更快的冷启动与更低的内存占用。Tauri / Rust 对比 Electron。
- 现代功能。冲突预测器、密钥扫描、monorepo 范围、文件时间线、团队活动、AI explain — 这些 GitKraken 都没有。
- 活跃的发布节奏。每 1-2 周更新一次,附带公开 changelog。
如果你决定回到 GitKraken
两款应用都对 `.git` 目录只读 — 切回只需重新启动 GitKraken。无数据锁定。49 EUR/年是按年订阅,可在任意续费周期停止付费。
上述迁移首次大约需要 15 分钟。在某个周五下午做一次,接下来的一周用 GitSquid。一周结束时,你就会知道节省下的费用 + 现代功能是否能为你的具体工作流抵消其权衡。
下载 GitSquid Free 立即开始。