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.
Checking the stable version of the documentation...
Sistema de alertas do GDScript
O sistema de alertas do GDScript complementa o static typing (mas você pode trabalhar sem tipagem estática também). Ele está aqui para te ajudar a evitar erros que são difíceis de perceber durante o desenvolvimento, e que podem levar a erros em tempo de execução.
Você pode configurar os avisos nas Configurações do Projeto sob a seção chamada GDScript:
Nota
Você deve ativar as Configurações Avançadas para ver a seção GDScript na barra lateral. Você também pode pesquisar por "GDScript" quando as Configurações Avançadas estiverem desativadas.
Você pode encontrar uma lista de avisos para o arquivo GDScript ativo na barra de status do editor de script. O exemplo abaixo possui 2 avisos:
Para ignorar avisos individuais dentro de um arquivo, use la anotação @warning_ignore. Você pode clicar no link de ignorar à esquerda da descrição do aviso. O Godot adicionará uma anotação acima da linha correspondente e o código não gerará mais o aviso correspondente:
Para ignorar múltiplos avisos em uma região dentro de um arquivo, use as anotações @warning_ignore_start e @warning_ignore_restore. Você pode omitir @warning_ignore_restore se quiser ignorar os tipos de aviso especificados até o final do arquivo.
Os nomes dos avisos a serem ignorados correspondem aos nomes das configurações do projeto. Por exemplo, para ignorar o aviso configurado pela configuração de projeto debug/gdscript/warnings/unused_variable, use @warning_ignore("unused_variable"). Uma caixa de diálogo de preenchimento automático é exibida ao inserir um nome de aviso na anotação, listando todos os avisos disponíveis.
Os avisos não impedirão o jogo de rodar, mas você pode transformá-los em erros se desejar. Dessa forma, seu jogo não compilará a menos que você corrija todos os avisos. Vá para a seção GDScript das Configurações do Projeto para ativar essa opção para o aviso que você deseja. Aqui está o mesmo arquivo do exemplo anterior com o aviso unused_variable ativado como um erro:
