Système d’avertissement de GDScript

Le système d'avertissement de GDScript complète le typage statique (mais il peut aussi fonctionner sans typage statique). Il est là pour vous aider à éviter les erreurs difficiles à repérer pendant le développement, et qui peuvent conduire à des erreurs d'exécution.

Vous pouvez configurer les avertissements dans les paramètres du projet, dans la section intitulée Gdscript :

Note

Vous devez activer les Advanced Settings pour voir la section GDScript dans la barre latérale. Vous pouvez également rechercher "GDScript" lorsque les paramètres avancés sont désactivés.

Vous pouvez trouver une liste des avertissements pour le fichier GDScript actif dans la barre d'état de l'éditeur de script. L'exemple ci-dessous comporte 2 avertissements :

Pour ignorer des avertissements spécifiques dans un fichier, utilisez l'annotation @warning_ignore. Vous pouvez cliquer sur le lien ignorer à gauche de la description de l'avertissement. Godot ajoutera une annotation au-dessus de la ligne correspondante et le code ne déclenchera plus l'avertissement correspondant :

To ignore multiple warnings in a region within a file, use the @warning_ignore_start and @warning_ignore_restore annotations. You can omit @warning_ignore_restore if you want to ignore the specified warning types until the end of the file.

Les avertissements n'empêcheront pas le jeu de fonctionner, mais vous pouvez les transformer en erreurs si vous le souhaitez. De cette façon, votre jeu ne sera pas compilé à moins que vous ne corrigiez tous les avertissements. Allez dans la section GDScript des paramètres du projet pour activer cette option pour l'avertissement souhaité. Voici le même fichier que l'exemple précédent avec l'avertissement unused_variable défini comme étant une erreur :