Первая программа на Dart

Изучая язык программирования, лучше всего сначала не заучивать правила грамматики, а запустить программу, а затем построчно разбираться, что она означает.

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

Стандартное расширение файла языка Dart.dart, напримерhello.dart。


Простейшая программа: Hello, Dart!

Откройте DartPadhttps://dartpad.dev(или создайте файл hello.dart в локальном редакторе), введите следующий код:

Пример

void main() {
  print('Hello, Dart!');
}

Нажмите «Запустить», вывод:

Hello, Dart!

Команда для запуска в локальной среде:

dart hello.dart

Всего 3 строки кода. Теперь давайте разберём каждый символ.


Построчный анализ

void main() {

Это объявление входной функции программы. Программы на Dart всегда начинают выполняться с main().

Разберём это по частям:

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

main() — единственная точка входа Dart. Независимо от того, сколько файлов или классов в вашей программе, выполнение всегда начинается с первой строки main().

print('Hello, Dart!');

Это инструкция, которая выводит содержимое внутри круглых скобок в консоль.

Разберём это по частям:

ЧастьЗначение
printИмя встроенной функции, используемой для вывода строки текста в консоль.
(...)Список параметров вызова функции
'Hello, Dart!'Строковый литерал, заключённый в одинарные кавычки '.
;Терминатор инструкции. Каждая инструкция должна заканчиваться точкой с запятой.
Ведущие два пробелаОтступ, указывающий, что эта строка кода принадлежит функции main(). В Dart принято использовать 2 пробела для отступа.

}

Закрывающий маркер тела функции main(), парный открывающей {.

Общая схема структуры

void main() {          ← 函数签名(返回类型 + 函数名 + 参数)
  print('Hello,        ← 函数体:调用 print 函数
         Dart!');      ← 传入字符串参数,以 ; 结尾
}                      ← 函数体结束

Два способа записи строк

В Dart строки можно заключать как в одинарные, так и в двойные кавычки; они полностью эквивалентны.

Пример

void main() {
  print('Hello, Dart!');   // Одинарные кавычки
  print("Hello, Dart!");   // Двойные кавычки, тот же эффект
}
Hello, Dart!
Hello, Dart!

Когда следует использовать какой тип кавычек? Можно руководствоваться следующими сценариями:

СценарииРекомендуетсяПример
Обычный случайОдинарные кавычки (соглашение сообщества Dart)'Hello'
Строка содержит одинарные кавычкиДвойные кавычки"It's a beautiful day!"
Строка содержит двойные кавычкиОдинарные кавычки'He said: "Hello"'

Когда само содержимое строки содержит одинарные кавычки, обернуть её в двойные кавычки удобнее и позволяет избежать экранирования. Соглашение сообщества Dart предпочитает одинарные кавычки, и в дальнейшем в этом руководстве в основном будут использоваться одинарные кавычки.


Комментарии

Комментарии — это пояснительный текст, написанный для людей; компилятор Dart полностью их игнорирует.

Пример

void main() {
  // Это однострочный комментарий, от // до конца строки
  print('Hello, Dart!'); // Можно также написать после инструкции

  /*
Это многострочный комментарий.
Может занимать несколько строк,
Часто используется, чтобы временно закомментировать большой блок кода.
  */


  /// Это документирующий комментарий, используемый для описания назначения функций, классов или переменных.
  /// IDE отображают документирующие комментарии как всплывающие подсказки при наведении.
}
Типы комментариевСинтаксисНазначение
Однострочный комментарий// contentОбъяснить строку кода
Многострочный комментарий/* content */Закомментировать блок кода или написать более длинное пояснение
Документирующий комментарий/// contentДля описания API и генерации документации

Хорошие комментарии объясняют «почему», а не «что было сделано». Код сам уже показывает «что было сделано»; комментарии должны дополнять причину или намерение, стоящие за ним.


Переменные: именование данных

Программа не может выводить только фиксированный текст; нам нужны переменные для хранения и использования данных.

Пример

void main() {
  String name = 'EXAMPLE';
  int age = 25;
  double height = 1.68;
  bool isStudent = true;

  print(name);
  print(age);
  print(height);
  print(isStudent);
}
EXAMPLE
25
1.68
true

Формат объявления переменной

类型名  变量名  =  初始值  ;
 │       │         │    └─ 语句结束符
 │       │         └─ 赋值运算符
 │       └─ 你给这个数据起的名字
 └─ 告诉 Dart 这个变量存储什么类型的数据

Краткий обзор базовых типов данных

TypeОписаниеПример
StringТекстовая строка'EXAMPLE'、"hello"
intInteger25、-10、0
doubleДесятичные числа (числа с плавающей точкой)1.68、3.14
boolЛогическое значение (true/false)true、false

Подробности о типах данных будут рассмотрены в следующих главах; здесь мы лишь получим предварительное представление.


Используйте var для автоматического вывода типа

Немного утомительно каждый раз писать имя типа.

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

Пример

void main() {
  var name = 'EXAMPLE';    // выводится как String
  var age = 25;           // выводится как int
  var height = 1.68;      // выводится как double
  var isStudent = true;   // выводится как bool

  print(name);
  print(age);
}
EXAMPLE
25

Тип, выведенный с помощью var, определяется во время компиляции; после этого вы не можете присвоить ему значение другого типа.

Пример

void main() {
  var name = 'EXAMPLE';
  name = 'Bob';    // ОК, всё ещё String
  // name = 123; // Ошибка: нельзя присвоить int переменной типа String
}

Когда следует использовать var, а когда нужно явно указывать тип?

СценарииРекомендуетсяПричина
Локальные переменные, тип очевиден с первого взглядаvarБолее лаконично
Параметры функций, поля класса и возвращаемые типы.Указывайте типКод становится понятнее и самодокументируемым

Интерполяция строк: встраивание переменных в строки

Если вы хотите встроить значение переменной в строку, Dart предоставляет очень лаконичный синтаксис интерполяции строк — используйте $variableName или ${expression}.

Пример

void main() {
  var name = 'EXAMPLE';
  var age = 25;

  print('Меня зовут $name, и мне $age лет.');
  print('В следующем году мне будет ${age + 1} лет.');
}
我叫 EXAMPLE,今年 25 岁。
明年我将 26 岁。
СинтаксисНазначениеПример
$variableNameПрямое встраивание значений переменных, лаконично$name
${expression}Встраивайте любое выражение (вычисление, вызов метода и т. д.).${age + 1}、${name.toUpperCase()}

По сравнению с конкатенацией строк, такой как print('Меня зовут ' + name + ', в этом году мне ' + age.toString() + ' лет.'), синтаксис интерполяции понятнее, безопаснее и является идиоматичным стилем в Dart.


Чуть более полная небольшая программа

Теперь давайте объединим то, что мы изучили ранее, и напишем чуть более реалистичную программу: простой генератор самопрезентации.

Пример

void main() {
  // Личная информация
  var name = 'EXAMPLE';
  var age = 25;
  var city = 'Шанхай';
  var isStudent = false;
  var hobby = 'программирование на Dart';

  // Создать представление: тернарный оператор определяет статус
  var occupation = isStudent ? 'студент' : 'специалист';

  print('=============================');
  print(' Личный профиль');
  print('=============================');
  print('Имя: $name');
  print('Возраст: $age');
  print('Город: $city');
  print('Статус: $occupation');
  print('Хобби: $hobby');
  print('-----------------------------');
  print('Всем привет, я $name из $city,');
  print('Мне $age лет в этом году, и я $occupation.');
  print('Моё хобби — ${hobby}, приятно познакомиться!');
  print('=============================');
}
=============================
       个人简介
=============================
姓名:EXAMPLE
年龄:25 岁
城市:上海
身份:职场人
爱好:Dart 编程
-----------------------------
大家好,我是来自上海的EXAMPLE,
今年 25 岁,是一名职场人。
我的爱好是Dart 编程,很高兴认识大家!
=============================

Новый синтаксис: тернарный оператор

Пример

var occupation = isStudent ? 'студент' : 'специалист';

Это тернарный оператор Dart, записывается так:

condition ? value when the condition is true : value when the condition is false

Эквивалентно следующей форме if/else:

Пример

String occupation;
if (isStudent) {
  occupation⟦⟧'Ютубер' = 'Student';
} else {
  occupation = 'Профессионал';
}

Тернарный оператор очень лаконичен, когда у значения есть только две возможности. В следующих главах будет подробно рассказано о полном использовании if/else.


Стиль кода: написание на Dart.

Хороший стиль кода делает код более читаемым и профессиональным.

У Dart есть официальное руководство по стилю; на начальном этапе достаточно освоить следующие пункты.

Используйте 2 пробела для отступов

Пример

// Правильно: 2 пробела
void main() {
  print('Hello');
}

// Не рекомендуется: 4 пробела (распространено в других языках, но сообщество Dart предпочитает 2)

Имена переменных и функций используют lowerCamelCase (lowerCamelCase).

Пример

var firstName = 'EXAMPLE';     // lower camel case: верно
// var first_name = 'EXAMPLE'; // стиль с подчёркиванием: не соглашение Dart
// var FirstName = 'EXAMPLE'; // PascalCase: зарезервировано для имён классов

Имена классов используют UpperCamelCase.

Пример

class UserProfile { }   // верно
// class user_profile { } // Неверно
// class userProfile { } // Неверно

Константы используют lower camel case (не всё заглавными буквами)

Пример

const maxRetries = 3;       // Соглашение Dart: правильно
// const MAX_RETRIES = 3; // Это стиль C/Java, не рекомендуется в Dart

Используйте dart format для автоматического форматирования.

Вам не нужно запоминать правила; просто запустите в каталоге проекта:

$ dart format .

Официальный инструмент форматирования Dart автоматически приводит код к стандартному стилю; в VS Code также можно настроить автоматическое форматирование при сохранении.


Распространённые ошибки и пояснения

Новички часто сталкиваются со следующими ошибками при написании своей первой программы; давайте с ними ознакомимся.

Ошибка 1: Забытая точка с запятой

Пример

void main() {
  print('Hello, Dart!')  // отсутствует ;
}

Сообщение об ошибке:

Error: Expected ';' after this.

Решение: добавьте ; в конце инструкции.

Ошибка 2: Несовпадающие круглые скобки

Пример

void main() {
  print('Hello, Dart!'   // отсутствует закрывающая круглая скобка )
}

Сообщение об ошибке:

Error: Expected ')' before this.

Решение: внимательно проверьте, что каждой ( соответствует ). VS Code подсветит несовпадающие скобки.

Ошибка 3: несовпадающие кавычки строки

void main() {
  print('Hello, Dart!");  // 一个单引号、一个双引号
}

Сообщение об ошибке:

Error: Unterminated string literal.

Решение: убедитесь, что оба конца строки используют один и тот же тип кавычек.

Ошибка 4: main написано с ошибкой

Пример

void Main() {  // M с заглавной буквы
  print('Hello, Dart!');
}

Dart чувствителен к регистру; Main и main — совершенно разные имена.

Программа компилируется, но во время выполнения выдаст ошибку:

Error: No 'main' method found.

Решение: входная функция должна быть main в нижнем регистре.

Ошибка 5: переменная используется до присваивания

Пример

void main() {
  String name;
  print(name);  // name не инициализирована
}

Ошибка null-safety в Dart:

Error: Non-nullable variable 'name' must be assigned before it can be used.

Решение: присвойте начальное значение при объявлении переменной или объявите её как nullable-тип String? name (подробнее в следующих главах).

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