快速開始

從安裝到第一次推送，大約十分鐘。全程不需要登錄。

準備

• 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、改寫
• 衝突 — 逐塊解決
• 多倉庫工作區 — 一次看多個倉庫