Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

版本控制系統

前言

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

版本控制系統

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

截至 2023 年 7 月,尚且只有一個 Git 外掛程式可用,但社區可能會建立其他的 VCS 外掛程式。

官方 Git 外掛

警告

截至2023年7月,Git外掛程式還沒有更新到可以配合 Godot 4.1以及更高的版本使用。

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

若想參與貢獻說明文件,則可在 此處 找到其儲存庫。

在版本控制系統中忽略的檔案

備註

這裡列出了 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/:此資料夾儲存各種專案快取資料。

  • *.translation :依據 CSV 檔產生,二進位匯入的翻譯。

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

在專案管理器的“新建專案”對話方塊中建立版本控制中繼資料

在專案管理器的 新建專案 對話方塊中建立版本控制中繼資料

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

在 Windows 上使用 Git

Windows 上大多數的 Git 使用者端都會將 core.autocrlf 設為 true 。這個設定會使檔案被 Git 標記為已修改,因為這些檔案的行結尾會自動被轉換。最好更改這個選項:

最好將此選項設定為:

git config --global core.autocrlf input

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