# Git 與原始檔控制

在一般的 Git 儲存庫中審閱差異、暫存檔案，並儲存里程碑。

用 Git 來保存你想命名的版本：完成的一章、寄給指導教授的修訂版，或是投稿所依據的原始碼。它在本機運作，不需要 GitHub 帳號。

![LLaMA 中的原始檔控制。開啟已變更的檔案來審閱，然後暫存你想放進下一次提交的檔案。](https://cdn.oleafly.com/images/screenshots/desktop/docs/source-control-dark-window-v2.png#view=0,45,344,513)

![並排檢視差異，暫存後提交。](https://cdn.oleafly.com/images/gifs/desktop/git-commit.gif?v=2)

## 開啟原始檔控制

從專案側欄開啟 **原始檔控制**。面板會顯示目前的分支、已暫存的檔案和工作中的變更。

按一下檔案可查看它的差異。你可以在並排檢視和統一檢視之間切換、在各個變更之間移動，也可以直接編輯工作中的副本。已暫存的差異維持唯讀。

檔案總管會用與原始檔控制相同的字母標示已變更的檔案，例如 M 表示已修改、A 表示已新增、D 表示已刪除、U 表示未追蹤。檔案名稱維持原本的顏色，含有變更的資料夾會顯示一個圓點。請參閱 [檔案與資料夾](/docs/files/)。

## 第一次提交

Oleafly 建立或匯入專案時，會設定一個 Git 儲存庫，並把專案的檔案記錄為一次名為「Create project」的提交。這樣原始檔控制從一開始就能顯示真正的差異。這次提交絕不會執行 Git hook 和提交簽署，因此全域的 hook 或簽署提示不會阻擋專案的建立。

在下列情況下，Oleafly 會略過第一次提交：

- 專案檔案的總大小超過 100 MB；
- 有通常存放密碼或金鑰的檔案，例如 `.env`、`*.pem`、SSH 私密金鑰或 `credentials.json`。機密一旦提交，即使之後把它加入忽略清單，仍會留在歷史記錄中。`.env.example` 這類範本、公開金鑰和 Keynote 的 `.key` 檔案不算在內。

略過提交時，儲存庫仍然會建立。所有檔案都維持未追蹤，由你自己處理，應用程式記錄會說明原因。

開啟一個沒有儲存庫的專案時，只會執行 `git init`；絕不會提交。第一次提交之後，Oleafly 只會在你要求時才提交。你原地開啟的資料夾不會被動，已經位於另一個儲存庫內的資料夾也一樣。

要關閉這一切，請在 **設定 → 整合 → GitHub** 中關閉 **為每個專案初始化 Git**。這樣原始檔控制只會在你按下 **初始化儲存庫** 或發布到 GitHub 時才啟用。

## 沒有安裝 Git 時

Oleafly 使用你電腦上安裝的 Git。沒有 Git 時，專案仍然可以開啟和編譯。原始檔控制會顯示 **未安裝 Git**，並說明如何為你的系統取得 Git，而不是顯示會失敗的按鈕：

- **Windows**：選擇 **下載 Git for Windows**，安裝 Git，然後重新啟動 Oleafly。
- **macOS**：在終端機中執行 `xcode-select --install` 來安裝 Apple 的命令列工具，其中包含 Git。**複製指令** 會替你複製它。然後重新整理面板。
- **Linux**：用你的套件管理員安裝 `git` 套件，然後重新整理面板。

## 儲存里程碑

![提交標題、選用的說明、提交、推送和提取控制項，位於已變更檔案清單的下方。](https://cdn.oleafly.com/images/screenshots/desktop/docs/source-control-dark-window-v2.png#view=0,815,344,260)

1. 審閱已變更的檔案。
2. 暫存你想放進這次提交的檔案。
3. 寫一則描述結果的訊息，例如 `Revise methods and add calibration figure`。
4. 提交。

**提交** 旁邊的選單還提供 **修改上次提交**、**提交並推送** 和 **提交並同步**。這些都是一般的 Git 提交。你可以用其他 Git 用戶端或命令列檢視同一個儲存庫。

## 分支與擱置

按一下面板頂端的分支名稱，可以切換分支或選擇 **建立分支…**。**更多原始檔控制操作** 選單中有 **擷取**、**提取**、**推送**、**同步**、**擱置變更** 和 **套用最近的擱置**。

提取或擱置遇到衝突時，面板會列出有衝突的檔案。對每一個檔案，選擇 **使用目前版本**、**使用傳入版本**，或編輯檔案後選擇 **標記為已解決**。合併期間，每個檔案都解決後就可以使用 **完成合併**，而 **中止合併** 會讓檔案回到合併開始之前的樣子。

## 還原提交

開啟 **版本管理 → Git 歷史記錄**，選擇一次提交，並檢視還原確認。還原會用那個版本取代已追蹤的專案內容，並重新載入已開啟的編輯器緩衝區。你的分支仍停留在目前的提交上。

如果你想要在成功編譯之後自動擷取的快照，請使用 [已儲存的檢查點](/docs/checkpoints/)。那些快照是分開存放的；它們不會建立 Git 提交。

## 加入遠端

想要一份異地備份，或想在電腦之間轉移工作時，請連接 GitHub。**發布到 GitHub**、**推送** 和 **提取** 都在原始檔控制面板中。

[設定 GitHub 同步 →](/docs/github-sync/)
