最佳化建置檔案大小

說明

有時候希望以檔案大小為優先進行最佳化，而非速度。這意味著不會編譯引擎中未使用的函式，並利用特定的編譯器旗標來協助縮小建置檔案。常見情境包含針對行動裝置與 Web 平台建立建置檔。

本教學旨在概述各種縮小二進位檔的方法。在繼續之前，建議先閱讀針對各平台編譯 Godot 的相關教學。

以下選項依照重要程度（節省空間最多到最少）的順序排列。

移除二進位檔符號

• 節省空間： 非常高

• 難度： 簡單

• 官方建構是否執行： 是

如果你從原始碼建構 Windows（MinGW）、Linux 或 macOS 的二進位檔，請記得透過發行版安裝 strip 套件，然後執行下列指令以移除除錯符號：

strip path/to/godot.binary

在 Windows 上，大多數 MinGW 工具鏈都已內含 strip.exe。

這樣做能將編譯後的二進位檔案縮小至原本的五分之一到十分之一。缺點是當機回溯將無法再提供準確資訊（此對於排除當機原因很有幫助）。C++ 性能分析工具 也無法顯示函式名稱（但不影響內建的 GDScript 性能分析器）。

備註

上述指令無法用於以 MSVC 編譯的 Windows 二進位檔，以及 Android 和 Web 等平台。請改為在 SCons 編譯指令列加上 debug_symbols=no。

以連結時期最佳化（LTO）編譯

• 節省空間： 高

• 難度： 簡單

• 官方建構是否執行： 是

啟用連結時期最佳化（LTO）能讓二進位檔效能與檔案大小更有效率。LTO 會消除重複的樣板函式與未使用的程式碼。目前可於 GCC 與 MSVC 編譯器使用：

scons target=template_release lto=full

啟用此選項會導致連結過程更慢，且消耗更多記憶體，因此建議僅用於正式釋出版本：

• 編譯 master 分支時，若啟用 LTO，需至少 8 GB 可用記憶體才能成功連結。

• 編譯 3.x 分支時，若啟用 LTO，需至少 6 GB 可用記憶體才能成功連結。

優先最佳化大小而非速度

• 節省空間： 高

• 難度： 簡單

• 官方建構是否執行： 是，但僅限於 Web 平台

自 Godot 3.1 起可選擇以檔案大小為優先進行最佳化。啟用方式為將 optimize 旗標設為 size：

scons target=template_release optimize=size

某些平台（如 WebAssembly）預設即使用此模式。

停用進階文字伺服器

• 節省空間： 高

• 難度： 簡單

• 官方建構是否執行： 否

Godot 預設使用進階文字伺服器，支援以下功能：

• 支援由右至左排版與複雜文字腳本，這對阿拉伯文、希伯來文等語言是必要的。

• 字體連字與 OpenType 功能（如小型大寫字母、分數、斜線零）。

Godot 也提供一個預設不會編譯的備用文字伺服器。這個備用文字伺服器可作為輕量級選擇，取代進階文字伺服器：

scons target=template_release module_text_server_adv_enabled=no module_text_server_fb_enabled=yes

若你的專案僅需支援拉丁文、希臘文與西里爾文等語系，備用文字伺服器就已足夠。

此外，備用文字伺服器處理大量文字的速度也比進階文字伺服器快，因此很適合用於行動裝置或 Web 專案。

備註

使用 module_text_server_adv_enabled=no 時，請務必同時加上 module_text_server_fb_enabled=yes，否則編譯出來的二進位檔將不包含任何文字伺服器，專案執行時將無法顯示任何文字。

停用 3D 支援

• 節省空間： 中等

• 難度： 簡單

• 官方建構是否執行： 否

對於 2D 遊戲而言，完整的 3D 引擎通常不必要，因此可使用建置旗標將其停用：

scons target=template_release disable_3d=yes

必須同時停用 Tools 功能才能啟用此旗標，因為 Godot 編輯器設計上必須支援 3D。停用 3D 支援後，二進位檔大小約可減少 15%。

備註

停用 3D 支援會一併停用所有導航功能。這也包含 2D 導航，因為 2D 導航系統底層實作依賴 3D 導航系統。

停用進階 GUI 元件

• 節省空間： 中等

• 難度： 簡單

• 官方建構是否執行： 否

大多數小型遊戲不需要如 Tree、ItemList、TextEdit 或 GraphEdit 等複雜 GUI 控制元件。可使用建置旗標將這些元件停用：

scons target=template_release disable_advanced_gui=yes

停用後將無法使用下列元件：

• AcceptDialog

• CharFXTransform

• CodeEdit

• CodeHighlighter

• ColorPickerButton

• ColorPicker

• ConfirmationDialog

• FileDialog

• GraphEdit

• GraphElement

• GraphFrame

• GraphNode

• HSplitContainer

• MenuBar

• MenuButton

• OptionButton

• class_PopupMenu`（將使所有使用此元件的類別，如 :ref:`class_LineEdit，在程式中無法使用彈出式選單，但這些類別本身仍可用）

• RichTextEffect

• RichTextLabel

• SpinBox

• SplitContainer

• SubViewportContainer

• SyntaxHighlighter

• TextEdit

• TreeItem

• Tree

• VSplitContainer

停用不需要的模組

• 節省空間： 非常低到中等，視模組而定

• 難度： 中等至困難，視模組而定

• 官方建構是否執行： 否

Godot 許多功能都以模組形式提供。你可以用下列指令查看模組列表：

scons --help

會顯示所有可停用的模組以及建置選項。若你正在開發簡單的 2D 遊戲，這些模組多數都可直接停用：

scons target=template_release module_basis_universal_enabled=no module_bmp_enabled=no module_camera_enabled=no module_csg_enabled=no module_dds_enabled=no module_enet_enabled=no module_gridmap_enabled=no module_hdr_enabled=no module_jsonrpc_enabled=no module_ktx_enabled=no module_mbedtls_enabled=no module_meshoptimizer_enabled=no module_minimp3_enabled=no module_mobile_vr_enabled=no module_msdfgen_enabled=no module_multiplayer_enabled=no module_noise_enabled=no module_navigation_enabled=no module_ogg_enabled=no module_openxr_enabled=no module_raycast_enabled=no module_regex_enabled=no module_squish_enabled=no module_svg_enabled=no module_tga_enabled=no module_theora_enabled=no module_tinyexr_enabled=no module_upnp_enabled=no module_vhacd_enabled=no module_vorbis_enabled=no module_webrtc_enabled=no module_websocket_enabled=no module_webxr_enabled=no module_zip_enabled=no

若這樣的設定不適用於你的專案，請自行檢查模組列表，確認遊戲實際需求。例如，你可能需要保留與網路相關的模組、正規表示式支援、音樂播放的 minimp3/ogg/vorbis，或播放影片的 theora 等模組。

此外，你可以在原始碼根目錄建立 custom.py，以清單方式指定要停用的模組，其內容類似如下：

custom.py

module_basis_universal_enabled = "no"
module_bmp_enabled = "no"
module_camera_enabled = "no"
module_csg_enabled = "no"
module_dds_enabled = "no"
module_enet_enabled = "no"
module_gridmap_enabled = "no"
module_hdr_enabled = "no"
module_jsonrpc_enabled = "no"
module_ktx_enabled = "no"
module_mbedtls_enabled = "no"
module_meshoptimizer_enabled = "no"
module_minimp3_enabled = "no"
module_mobile_vr_enabled = "no"
module_msdfgen_enabled= "no"
module_multiplayer_enabled = "no"
module_noise_enabled = "no"
module_navigation_enabled = "no"
module_ogg_enabled = "no"
module_openxr_enabled = "no"
module_raycast_enabled = "no"
module_regex_enabled = "no"
module_squish_enabled = "no"
module_svg_enabled = "no"
module_tga_enabled = "no"
module_theora_enabled = "no"
module_tinyexr_enabled = "no"
module_upnp_enabled = "no"
module_vhacd_enabled = "no"
module_vorbis_enabled = "no"
module_webrtc_enabled = "no"
module_websocket_enabled = "no"
module_webxr_enabled = "no"
module_zip_enabled = "no"

也參考

覆寫建置選項 。

最佳化專案散佈方式

桌上型電腦

備註

本節僅適用於檔案發佈於未自帶壓縮或封包機制的桌機平台。例如，你在 itch.io 或 GitHub Releases 上提供 ZIP 壓縮檔時，以下建議就很有幫助。

像 Steam 這類平台已自動進行壓縮，因此不需要再自行打包 ZIP 檔案。

此外，你也可以針對專案分發本身進行最佳化。即使不重新編譯匯出範本，也能採取這些措施。

7-Zip 可用來建立壓縮效率更高的 ZIP 檔案，且與所有 ZIP 解壓縮工具（包含 Windows 內建的）相容。對大型專案來說，與一般 ZIP 工具相比，壓縮後可減少數十 MB，平均則能省下 1-5 MB 空間。建立這類 ZIP 檔所需時間較長，但解壓速度與普通 ZIP 檔無異。

若用 7-Zip 圖形介面，請選擇「Ultra」壓縮等級來建立 ZIP 檔。若用命令列，請執行下列指令：

7z a -mx9 my_project.zip folder_containing_executable_and_pck

Web

針對 Web 匯出檔案（特別是 .wasm 與 .pck 等），開啟 gzip 或 Brotli 壓縮能大幅減少下載量，進而加快載入速度，尤其適用於慢速網路連線。

如果網頁伺服器能正確傳送預先壓縮好的 gzip 或 Brotli 檔案，建議直接產生高壓縮等級的這類檔案，效果會更好。若伺服器支援，Brotli 通常比 gzip 有更高壓縮比，建議優先選用。

詳情請參考 提供檔案服務 。