GodotHub 數據與遷移手冊：備份、換機與退路評估

GodotHub 是什麼

GodotHub 是一個專為 Godot 遊戲引擎開發者打造的輔助管理工具，雖然不是官方發布的，但在國內開發圈裡用的人不少。它的核心定位是：把散落在各處的 Godot 引擎版本、插件資源、社區模板，整合到一個地方集中管理，讓開發者不用每次換個引擎版本就重新找下載頁、重新調環境。

它主要做幾件事：整理各版本的 Godot 引擎下載，幫你在同一台電腦上裝多個版本並給每個項目綁定不同版本；提供插件庫和社區模板的瀏覽與下載；手機端隨時掃一眼項目進度。對個人獨立開發者或小團隊來說，一個工具把版本管理、項目組織、資源獲取這三件事包了，確實比自己手動建資料夾、手動切版本方便得多，更多細節可在 GodotHub官網 找到。

安裝

GodotHub 目前分兩個平臺：Android 端和桌面端（Windows / macOS）。Android 端的安裝比較直接，透過 GodotHub下載 取得 APK 檔後允許未知來源安裝即可，安裝包大小約 25 MB，版本更新頻率不算高（最新版 1.0.8，2026 年 9 月更新），主要修 bug 和補插件庫索引。

桌面端需要留意一個細節：GodotHub 本身是輕量應用，啟動快、記憶體佔用低，但它管理的 Godot 引擎安裝檔通常體積較大（每個版本 100~200 MB 不等），這些引擎檔默認放在 GodotHub 自己管理的目錄裡，而不是 Godot 引擎的默認位置。安裝時建議把 GodotHub 的引擎緩存目錄指到空間充足的盤符，別跟系統盤擠一起。

首次啟動後，Android 端會請求儲存讀寫權限，桌面端會掃描本機已有的 Godot 項目（你可以手動選擇掃描哪些資料夾，也可以跳過）。掃描這步可以後補，但先掃一遍能讓 GodotHub 自動幫你綁定項目與引擎版本，省得之後一個一個手動設。

數據存在哪裡

既然要談備份和遷移，先得搞清楚 GodotHub 到底在哪些地方寫了數據。它管的數據大體分三類：

第一類是它自己的數據庫，記錄項目列表、每個項目綁定的引擎版本、你收藏的插件、標記過的模板、已下載引擎的緩存索引。這類是 GodotHub 獨有的，Godot 編輯器完全不碰它。Android 端這份數據在應用私有目錄裡，桌面端在系統用戶目錄下的 AppData 或 Library 裡，具體路徑跟作業系統版本有關。

第二類是引擎安裝檔緩存，就是你透過 GodotHub 下載的各版本 Godot 引擎。這類體積大、內容是標準的 Godot 官方發布包，本身不包含你的個人數據，丟了隨時可以重下。

第三類是插件和模板下載記錄，GodotHub 只記錄你標記過哪些插件需要下載、哪些模板收藏了，實際插件檔案的存放位置通常在各個項目自己的 addons 目錄裡，那是 Godot 編輯器的管轄範圍，GodotHub 不碰。

這裡有一個重要的設計決定值得提：GodotHub 的項目與引擎綁定關係不寫入 Godot 編輯器的任何配置檔。也就是說，它跟 Godot 編輯器之間是完全鬆耦合的——Godot 編輯器不知道有 GodotHub 這個東西存在，反過來 GodotHub 也不改 Godot 編輯器的設定。好處是兩邊互不干擾，GodotHub 壞了、Godot 編輯器照跑；你卸載 GodotHub、項目代碼和場景檔案半根毛都不會動。

怎麼備份

備份的核心對象是第一類——GodotHub 的數據庫。這份裡面才有你花時間整理的項目分組、引擎綁定、收藏清單。

Android 端的備份相對麻煩一點，因為應用私有目錄預設不對其他應用開放。如果你有 root 權限可以直接把 /data/data/com.godothub.app/ 整個資料夾複製出來；沒有 root 的話，部分 Android 版本支援用 adb backup 做應用級備份，或者用備份工具掃描備份，恢復時還原回去即可。引擎緩存不用備份，重新下載比備份還快。

桌面端的備份簡單很多，因為文件都在你看得見的位置。Windows 下通常在 %APPDATA%\GodotHub\，macOS 下在 ~/Library/Application Support/GodotHub/——把那個資料夾整個複製到移動硬盤或雲端就完事了。引擎緩存目錄如果也想保留（省得重下），一併複製過去，路徑在 GodotHub 設定裡能看到。

有一點要注意：GodotHub文檔 裡沒有提到 GodotHub 是否支援雲端同步或帳號登入。從實際使用來看，它目前似乎沒有強制登入機制，所有數據都存在本地，所以備份完全靠你自己。這一條屬於文檔未明確記載的部分，我沒法確認未來版本會不會加雲同步，現在只能按本地備份來。

換設備遷移

換手機或換電腦時的遷移步驟，邏輯上就是「在新設備上裝 GodotHub → 還原備份數據庫 → 補裝引擎」。

具體來說，先在新設備上下好 GodotHub 並完成首次啟動（讓它建好資料夾結構），然後把舊設備備份的數據庫複製到新設備對應的位置。啟動後 GodotHub 就能讀到你之前的項目列表和引擎綁定——但這時它綁定的引擎版本檔案在新設備上其實還不存在，所以最後一步是在 GodotHub 裡點一下每個項目綁定的引擎版本，讓它自動下載。

如果舊設備上有從未遷移過的 Godot 項目（代碼和場景檔案），記得那些在 GodotHub 管轄之外，你得單獨用 Git、移動硬盤或雲盤把項目資料夾搬過來，再在新設備上讓 GodotHub 掃描一遍重新建立關聯。

遷移過程中容易斷的環節有兩個。第一個是 Android 端的應用私有目錄存取——如果沒 root 也沒有 adb，備份可能拿不到完整的數據庫。第二個是桌面端的路徑變更——舊電腦上你可能把引擎緩存指到了 D 盤的某個資料夾，新電腦上那個路徑不存在，GodotHub 會顯示引擎缺失，這時候重新下載就行，數據庫記錄的綁定關係不會因此丟失。

退路評估

哪天你不想用 GodotHub 了，數據能不能乾淨帶走、卸載會不會留下殘留，這是很多人關心的問題。

好消息是，GodotHub 管的數據本質上就是一份本地數據庫，沒有綁定任何雲端服務或帳號體系，所以不存在「數據鎖死」的問題——你想把那份數據庫搬去哪就搬去哪，想刪就刪。

卸載本身也乾淨：Android 端卸載會自動清除應用私有目錄；桌面端卸載程序會刪除應用本體和數據庫資料夾。引擎緩存目錄不會被自動刪除，因為那裡面放的是標準的 Godot 官方版本檔案，卸載程序不敢隨便動你的磁盤。所以卸載後記得手動清一下引擎緩存那個資料夾，不然幾百 MB 到幾 GB 的檔案就躺在那裡佔空間。

至於「卸載後項目會不會壞」，答案是不會。前面提過 GodotHub 跟 Godot 編輯器完全鬆耦合，項目檔案裡沒有任何對 GodotHub 的依賴。卸載 GodotHub 之後，你直接用 Godot 編輯器打開項目照樣跑，頂多就是得手動切版本了。

結論

GodotHub 的數據自主度總體上是比較健康的——本地存儲、無帳號綁定、與 Godot 編輯器完全解耦，卸載乾淨。但它目前沒有雲同步，所有數據都靠你自己備份，這一點對那些有多台開發設備的人來說不太方便。我的建議是：如果你經常切換設備或者習慣定期備份，把 GodotHub 的數據庫加入你的常規備份清單裡，花不了幾秒卻能在換機時省很多麻煩。

本文为个人基于网络公开资料整理编写，非官方内容，仅供学习交流参考；软件版权归原作者所有，请支持正版；使用过程中遇到问题请查阅官方渠道，本文不承担任何责任。