Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

项目设置

你可以通过更改数十种设置来控制项目的运行，包括物理、渲染和窗口设置。这些设置可以通过 项目设置 窗口、代码或手动编辑 project.godot 文件来修改。你可以在 ProjectSettings 类中查看完整的设置列表。

在内部，Godot 将项目的设置存储在一个 project.godot 文件中，这是一个 INI 格式的纯文本文件。虽然这种格式易于阅读且对版本控制友好，但直接编辑并不太方便。因此，可以通过 项目设置 窗口来编辑这些设置。要打开项目设置，请从主菜单中选择 项目 > 项目设置。

项目设置窗口

项目设置 窗口主要用于更改 常规 标签中的设置。此外，还有 输入映射、本地化、全局变量、插件 和 导入默认值 标签。这些其他标签的使用已在其他地方有文档说明。

修改项目设置

项目设置窗口的常规选项卡与检查器类似，显示的是项目设置列表，可以像检查器属性一样进行修改。左侧是类别列表，可以选择相关的设置组。还可以使用过滤设置框搜索特定的设置。

每个设置都有一个默认值。可以通过点击每个属性旁边的圆形箭头 重置 按钮，将设置恢复为默认值。

通过代码修改项目设置

你可以在代码中使用 set_setting() 来修改设置的值：

GDScriptC#

ProjectSettings.set_setting("application/run/max_fps", 60)
ProjectSettings.set_setting("display/window/size/mode", DisplayServer.WINDOW_MODE_WINDOWED)

然而，许多项目设置都只会在游戏启动时读取一次。在此之后，使用 set_setting() 更改设置就不会产生效果了。不过大多数设置在 Engine、DisplayServer 等运行时类上都有相应的属性或方法：

GDScriptC#

Engine.max_fps = 60
DisplayServer.window_set_mode(DisplayServer.WINDOW_MODE_WINDOWED)

通常，项目设置会在运行时复制到以下类中：Engine、PhysicsServer2D、PhysicsServer3D、RenderingServer、Viewport、Window。在 ProjectSettings 类的参考文档中，设置会链接到其对应的运行时属性或方法。

读取项目设置

你可以使用 get_setting() 或 get_setting_with_override() 来读取项目设置：

GDScriptC#

var max_fps = ProjectSettings.get_setting("application/run/max_fps")
var window_mode = ProjectSettings.get_setting("display/window/size/mode")

由于许多项目设置仅在启动时读取一次，项目设置中的值可能不再准确。在这种情况下，最好从运行时的等效属性或方法中读取值：

GDScriptC#

var max_fps = Engine.max_fps
var window_mode = DisplayServer.window_get_mode()

手动编辑 project.godot

You can open the project.godot file using a text editor and manually change project settings. Note that if the project.godot file does not have a stored value for a particular setting, it is implicitly the default value of that setting. This means that if you are manually editing the file, you may have to write in both the setting name and the value.

一般来说，建议使用项目设置窗口，不建议手动编辑 project.godot。

高级项目设置

高级项目设置

默认情况下只会显示部分项目设置。要查看所有项目设置，请启用高级设置切换按钮。