Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

GDScript 警告系统

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

可以在项目设置的 GDScript 部分配置警告:

../../../_images/typed_gdscript_warning_system_settings.webp

备注

要在侧边栏中看到 GDScript 部分的设置,必须启用 高级设置 选项;如果该选项未开启,也可以搜索 "GDScript" 来进行查找。

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

../../../_images/typed_gdscript_warning_example.webp

要忽略一个文件中的特定警告,请插入 @warning_ignore("warning-id") 注解,或点击警告说明右侧的忽略链接,Godot 将在相应的行上方添加该注解,该代码将不再触发相应的警告:

../../../_images/typed_gdscript_warning_system_ignore.webp

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

../../../_images/typed_gdscript_warning_system_errors.webp