GDScript 警告系统

GDScript警告系统补充了 :ref:`静态类型<doc_gdscript_static_typing>`(但也可以在没有静态类型的情况下工作).它可以帮助您避免在开发过程中难以发现的错误,并可能导致的运行时错误.

您可以在 项目设置 中的 Gdscript 部分配置警告:

Warning system project settings

警告系统在项目设置中的位置

你可以在脚本编辑器的状态栏中找到当前GDScript文件的警告列表.下面的例子有3个警告:

Warning system example

警告系统示例

要忽略一个文件中的特定警告,请插入类似 #warning-ignore:warning-id 形式的特殊注释,或点击警告说明右侧的忽略链接.Godot将在相应的行上方添加特殊注释,并且该代码将不再触发相应的警告:

Warning system ignore example

警告系统忽略示例

你可以选择使用 # warning-ignore-all:warning-id 忽略文件中一个或所有的针对某些类型的警告.要忽略所有类型的警告则在文件中添加 # warnings-disable 即可.

警告不会阻止游戏的运行,但是您可以根据需要将其转换为错误.这样,除非您修复所有警告,否则游戏无法编译.前往项目设置的 GDScript 部分打开此选项.这是与前一个示例相同的文件,并在启用了警告转成错误:

Warnings as errors

警告当作错误