快速開始

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

準備

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