Введение в аннотации в Dart

Аннотация - короткая пометка рядом с объявлением. Она не выполняется как обычный код: анализатор читает метку и может изменить диагностику, проверку типов или правила доступа к элементу.

Запись начинается с символа @ и имени пометки. Ее ставят перед функцией, классом, полем или другим объявлением, к которому относится смысл метки.

В языке уже есть @deprecated - она сообщает, что объявление лучше не использовать. Отдельно в ООП вы встречали @override для явного переопределения метода у потомка.

Другие готовые и свои пометки задают правила для инструментов и команды. У каждой метки свой смысл, но модель одна: анализатор видит пометку рядом с объявлением и действует по ее правилам. Программа при запуске эти метки сама не читает.