快速开始

从安装到第一次推送，大约十分钟。全程不需要登录。

准备

• macOS 12+、Windows 10+ 或 Linux；
• git 在 PATH 中，终端里 git --version 能跑通；
• Git LFS 仓库另外需要 git-lfs（可选）。

如果应用启动后提示找不到 Git，先看故障排查的「找不到 git」。

打开仓库

首次启动会显示引导页，三种入口：

1. 打开本地仓库 — 选择仓库根目录，或其子目录都可以；
2. 克隆远程仓库 — 填 URL 与目标目录，可选浅克隆、单分支、部分克隆、递归子模块；
3. 新建仓库 — 选一个空目录，以 main 为默认分支初始化。

之后每次打开用 ⌘O（Windows / Linux 为 Ctrl+O），或从「文件 → 最近打开」选择。窗口左侧的仓库栏可以切换最近仓库，标签页会保留已打开的仓库。

完成第一次提交

1. 在外部编辑器里改一个文件，回到应用；
2. 左侧切到「变更」（⌘2），选中该文件，中间显示 diff；
3. 按 Space 暂存整个文件；只想提交某个片段时，在 diff 里对片段或行单独暂存；
4. 在底部提交框写信息，⌘⏎ 提交；
5. 提交后状态栏出现提交号与「撤销」，60 秒内可以退回这次提交。

提交只包含已暂存的内容。提交框上方的「暂存全部」开关可以一次暂存所有未暂存文件。

同步

• ⌘⇧P 推送当前分支；
• 顶部的「获取」只更新远程跟踪分支，不合并；
• 「拉取」按「设置 → Git」里的拉取策略整合上游（合并、变基或仅快进）。

推送前会跑一次本地预检：新增的大文件、冲突标记、疑似密钥都会先列出来。详见同步。

键盘路径

完整列表见快捷键。

接下来

• 变更与暂存 — 片段与行级暂存、批量操作
• 历史 — 图谱、blame、改写
• 冲突 — 逐块解决
• 多仓库工作区 — 一次看多个仓库