GDScript 警告系统

GDScript 警告系统是对静态类型的补充(但也可以在没有静态类型的情况下工作)。它可以在开发过程中帮助您避免因难以发现的错误而导致运行时错误。

您可以在 项目设置 中的 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

警告当作错误