Юлия А.цитирует19 дней назад
прежде, чем вы начнете знакомиться с этими типами и их объявлением, необходимо поговорить о комментариях. Они в Dart делятся на два типа: однострочные и многострочные. В первом случае используется //, затем следует комментарий, который не переносится на следующую строку:
// комментарий
var a = 10; // еще один комментарий
print(a); // 10 <- такое обозначение будем использовать для значений,
// которые выводятся в терминал
Если комментарий будет занимать более двух строк, то необходимо либо каждую его строку начинать с //, либо использовать многострочный формат записи комментария:
/*
Сверхдлинный
комментарий
*/
var a = 10;
Комментарии можно использовать не только для того, чтобы комментировать происходящее в коде. Например, с их помощью можно исключить выполнение определенной строки или блока кода (то есть закомментировать их). Но сильно увлекаться этим не стоит, поскольку такой подход засоряет вашу кодовую базу, из-за чего в последующем у новых людей в команде обязательно возникнут трудности.
Строки же документации, которые позволяют использовать инструмент dartdoc для автоматической генерации документации вашего проекта, начинаются с ///.
  • Войти или зарегистрироваться, чтобы комментировать