Базовый синтаксис Dart

У каждого языка программирования есть свой набор базовых правил, и Dart не исключение.

В этой главе представлены базовая структура программ на Dart, синтаксис комментариев, разница между инструкциями и выражениями, а также соглашения об именовании идентификаторов.


Структура программы и функция main()

Суффикс имени файла Dart —.dart..., каждая программа Dart должна иметь точку входа — функцию main().

Выполнение программы начинается с первой строки функции main() и заканчивается на закрывающей фигурной скобке в последней строке.

Пример

Структура простейшей программы на Dart:

// Точка входа программы: функция main() — начальная точка программы на Dart
void main() {
  // Напишите здесь свой код
  print('Добро пожаловать в EXAMPLE Dart Tutorial!');
}
欢迎来到 EXAMPLE Dart 教程!

Давайте разберём каждую часть этого кода:

Элементы кодаОписание
voidТип возвращаемого значения; void означает, что функция не возвращает никакого значения
mainИмя функции; это имя функции входа, заданное Dart, и его нельзя изменить
()Список параметров; main() может не принимать параметров или принимать аргументы командной строки
{ }Тело функции; код внутри фигурных скобок — это то, что выполняет функция
print()Встроенная функция, используемая для вывода текста в консоль
;Терминатор инструкции; каждая инструкция в Dart должна заканчиваться точкой с запятой

Dart строго требует, чтобы каждая инструкция заканчивалась точкой с запятой (;). Забыть точку с запятой — самая распространённая синтаксическая ошибка среди новичков. К счастью, плагин Dart в VS Code автоматически указывает, где пропущены точки с запятой.

Функция main() с аргументами командной строки

Функция main() может принимать список строк в качестве аргументов командной строки:

Пример

// List<String> args получает список аргументов, переданных из командной строки
void main(List<String> args) {
  // Вывести количество аргументов
  print('Количество аргументов: ${args.length}');

  // Перебрать и вывести каждый аргумент
  for (var i = 0; i &lt; args.length; i++) {
    print('Аргумент $i: ${args[i]}');
  }
}
$ dart run hello.dart example dart 教程
参数个数:3
参数 0: example
参数 1: dart
参数 2: 教程

Здесь используется тип List и цикл for, которые мы подробно рассмотрим в следующих главах.


Синтаксис комментариев

Комментарии — это пояснения к коду; компилятор игнорирует содержимое комментариев.

Хорошие комментарии помогают другим (включая вас самих через несколько месяцев) быстрее понять замысел кода.

Dart поддерживает три стиля комментариев:

TypeСинтаксисПрименимые сценарии
Однострочный комментарий// содержимое комментарияКратко объяснить назначение строки кода
Многострочный комментарий/* Содержимое комментария */Подробное объяснение, занимающее несколько строк
Документирующий комментарий/// Документирующие комментарииГенерировать документацию API для функций и классов

Пример

/// Это документирующий комментарий, который описывает функциональность программы
/// Документирующие комментарии можно использовать для создания HTML-документации с помощью команды [dart doc]
void main() {
  // Однострочный комментарий: выводит приветственное сообщение
  print('Добро пожаловать в изучение Dart!'); // Однострочный комментарий: это тоже допустимо

  /*
* Многострочный комментарий: подходит для длинных пояснений
* Вторая строка комментария
* Третья строка комментария
   */

  print('ПРИМЕР Учебник - Основы синтаксиса Dart');
}
欢迎学习 Dart!
EXAMPLE 教程 - Dart 基础语法

Принцип комментариев — "объяснять почему, а не что". Сам код уже показывает, что он делает; комментарии должны объяснять, почему он написан именно так, или предоставлять справочную информацию, которую код не может выразить.


Инструкции и выражения

В Dart код состоит из инструкций и выражений.

Понимание разницы между ними помогает лучше организовать логику кода.

Выражение

Выражение — это фрагмент кода, который можно вычислить, и оно выдаёт значение.

Пример

void main() {
  // Каждая из следующих строк — это выражение; все они дают значение.
  42;              // Литеральное выражение, значение — 42
  3 + 5;           // Арифметическое выражение, значение равно 8
  'Hello'.length;  // Выражение доступа к свойству, значение равно 5
  (10 > 5);        // Выражение отношения, значение равно true
}

Инструкция

Инструкция — это команда, которая выполняет действие и не возвращает значение.

Пример

void main() {
  // Инструкция объявления переменной: объявляет переменную и присваивает значение
  var name = 'EXAMPLE';

  // Инструкция вызова функции: вызывает print() для выполнения действия вывода
  print(name);

  // Инструкция потока управления: определяет, какой код выполнять, в зависимости от условий
  if (name.length > 3) {
    print('Name length is greater than 3');
  }
}
EXAMPLE
名称长度大于 3

Кратко:Выражения порождают значения, инструкции выполняют действия.

Выражения можно использовать там, где требуется значение, но инструкции использовать нельзя.

Распространенное заблуждение — считать весь код «инструкциями». На самом деле многие конструкции в Dart (например, вызовы функций и присваивания переменным) сами являются выражениями, что означает, что их можно вкладывать друг в друга. Это общая характеристика Dart и других языков семейства C.


Соглашения об именовании идентификаторов

Идентификатор — это имя, которое вы даете элементам кода, таким как переменные, функции и классы.

В Dart есть некоторые правила и соглашения для идентификаторов:

Правила именования (обязательны для соблюдения)

Идентификаторы могут состоять только из букв, цифр, знаков подчеркивания (_) и знаков доллара ($).

Идентификаторы не могут начинаться с цифры.

Идентификаторы не могут быть зарезервированными ключевыми словами Dart (такими как class, if, var и т. д.).

Соглашения об именовании (рекомендуемые)

Элементы кодаСоглашения об именованииПример
Имя классаUpperCamelCaseStudentInfo、HttpClient
Перечисляемый типUpperCamelCaseColor、Status
Имена библиотек и файловlowercase_with_underscoresmy_utils、user_service
Имя переменнойlowerCamelCaseuserName、maxCount
Имя функцииlowerCamelCasegetUserInfo()、calculateTotal()
Имя константыlowerCamelCasepiValue、defaultPort
Закрытые членыПрефикс с подчеркиванием_internalState、_privateMethod()

Пример

Практическое применение различных стилей именования:

// Имя класса: UpperCamelCase
class UserAccount {
  // Публичные члены: lowerCamelCase
  String userName;

  // Приватные члены: префикс с подчеркиванием (доступны только внутри этого файла)
  String _password;

  // конструктор
  UserAccount(this.userName, this._password);

  // Публичные методы: lower camelCase
  bool verifyPassword(String input) {
    return input == _password;
  }

  // Приватные методы: префикс с подчёркиванием
  void _encryptPassword() {
    // Логика шифрования...
  }
}

// Функция входа: нижний регистр
void main() {
  // Имена переменных: lower camelCase
  var userAccount = UserAccount('example', '123456');

  // Константы: lower camelCase (стиль Dart)
  const maxLoginAttempts = 3;

  print('Имя пользователя: ${userAccount.userName}');
  print('Максимальное число попыток входа: $maxLoginAttempts');
}
用户名: example
最大登录尝试次数: 3

В соглашениях об именовании Dart константы используют lowerCamelCase, а не стиль со всеми заглавными буквами и подчёркиваниями (UPPER_CASE), распространённый в других языках. Это уникальный стиль сообщества Dart, поэтому обязательно помните о нём.

Другие расширения