版本控制系統

前言

Godot 的目標是做到 VCS 友好，生成的檔大多可讀、可合併。

Godot 旨在對 VCS 友善並儘量產生高可讀性與可合併的檔案。Godot 也支援在編輯器中使用版本控制系統。但在編輯器中使用版本控制系統需要安裝對應的外掛。可於 [專案] > [版本控制] 中設定或關閉版本控制系統。

截至 2023 年 7 月，尚且只有一個 Git 外掛程式可用，但社群可能會建立其他的版本控制 (VCS) 外掛程式。

可以使用官方外掛來在編輯器中使用 Git。可於此處取得最新版本 (該外掛不在素材庫中)。關於如何使用 Git 外掛的說明文件可參考此處 (英文) 。

有關 Git 外掛的使用說明，可參閱其 Wiki。

備註

這裡列出了 Godot 4.1 及更高版本中應從版本控制中被忽略的檔和資料夾。

Godot 3.x 和 Godot 4.0 中的版本控制應忽略的資料夾檔列表 ** 完全 ** 不同。這點非常重要，因為 Godot 3.x 和 4.0 可能會將敏感憑據儲存在 export_presets.cfg 中（這與 Godot 4.1 及更高版本不同）。

如果你正在使用 Godot 3，請查看本頁說明文件的 3.5 版本。

當第一次在編輯器中打開專案時，Godot 會自動建立一些檔和資料夾。為了避免生成的資料使版本控制倉庫膨脹，你應該將它們新增到 VCS 忽略中：

你可以選擇在 Godot 專案管理器建立專案時自動生成版本控制中繼資料。當選擇 Git 選項時，將在專案根目錄中建立 .gitignore 和 .gitattributes 檔案：

在現有的專案中，選擇編輯器頂部的專案功能表，然後選擇 版本控制 > 生成版本控制中繼資料。這將與在專案管理器中執行的操作一樣建立相同的檔。

大多數 Windows 上的 Git 用戶端預設會設定 core.autocrlf 為 true，這會造成 Git 自動將行尾從 LF 轉換為 CRLF，導致檔案被不必要地標記為已修改。

最好將此選項設定為：

git config --global core.autocrlf input

使用專案管理器或編輯器建立版本控制中繼資料時，會使用 .gitattributes 檔自動強制使用 LF 行尾，因此無需更改 Git 配置。