快速开始
Fox Git 是一个桌面 Git 客户端,所有 Git 操作都调用你电脑上的 Git。这一页带你完成安装前准备、打开第一个仓库,并认识工作台的主要区域。
准备 Git
Fox Git 要求系统 Git 2.36 或更高版本(worktree list -z 等能力需要这个版本)。在终端确认:
bash
git --version- macOS:安装 Xcode Command Line Tools,或使用 Homebrew 安装最新版 Git。
- Windows:安装 Git for Windows。
- Linux:使用发行版的包管理器安装或升级
git。
你的 ~/.gitconfig、仓库钩子、凭据助手和 SSH 配置会照常生效,Fox Git 不会另行维护一套 Git 配置。
安装 Fox Git
在下载页选择你的平台。Fox Git 目前处于开发预览阶段,安装包会随公开版本发布;在此之前下载按钮会说明如何申请早期体验。
打开第一个仓库
启动后可以通过三种方式开始:
| 方式 | 入口 | 说明 |
|---|---|---|
| 打开仓库 | ⌘O | 选择本地已有的 Git 仓库目录 |
| 克隆仓库 | ⌘⇧O | 填写 URL 与父目录,文件夹名会根据 URL 自动推断;显示阶段与进度,可随时取消 |
| 初始化仓库 | 命令面板 | 通过系统文件夹选择器选择或新建目录,执行 git init 后直接打开 |
克隆时如果远程需要用户名、密码、token 或 SSH 口令,Fox Git 会弹出认证框,详见远程同步。克隆失败或取消时,残留的目标文件夹会被清理;目标文件夹非空时会直接拒绝。
认识工作台
工作台左侧是活动栏,每个视图都有快捷键:
| 视图 | 快捷键 | 用途 |
|---|---|---|
| 资源管理器 | ⌘1 | 文件树与只读文件预览、Blame、文件历史 |
| 变更 | ⌘2 | Conflicts / Staged / Unstaged / Untracked 与提交 |
| 历史 | ⌘3 | 提交图谱、搜索与右键操作 |
| 分支 | ⌘4 | 本地分支、远程分支与标签 |
| 贮藏 | ⌘5 | 贮藏列表、文件与 diff |
| 工作树 | ⌘6 | 当前仓库的 worktree |
顶部工具栏常驻 Fetch、Pull、Push。⌘P 打开 Quick Switcher,可以搜索文件、变更、提交、分支和仓库;⌘⇧P 只搜索命令。Windows 与 Linux 上用 Ctrl 代替 ⌘。更多见快捷键与 Quick Switcher。
下一步
- 准备提交:阅读变更与提交。
- 理解一段代码的来历:阅读文件查看与 Blame。
- 遇到合并冲突:阅读冲突解决。