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.

GDScript 警告系统

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

You can configure warnings in the Project Settings under the section called GDScript:

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

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

备注

As shown in the image above, you must enable Advanced Settings in order to see the GDScript section.

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

警告系统示例

警告系统示例

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

警告系统忽略示例

警告系统忽略示例

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

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

警告当作错误

警告当作错误