Первая программа на Dart
Изучая язык программирования, лучше всего сначала не заучивать правила грамматики, а запустить программу, а затем построчно разбираться, что она означает.
В этой главе мы начнём с простейшей программы и постепенно расширим её до немного более полной небольшой программы, попутно знакомясь с самыми базовыми концепциями Dart.
Стандартное расширение файла языка Dart.dart, напримерhello.dart。
Простейшая программа: Hello, Dart!
Откройте DartPadhttps://dartpad.dev(или создайте файл hello.dart в локальном редакторе), введите следующий код:
Пример
print('Hello, Dart!');
}
Нажмите «Запустить», вывод:
Hello, Dart!
Команда для запуска в локальной среде:
dart hello.dart
Всего 3 строки кода. Теперь давайте разберём каждый символ.
Построчный анализ
void main() {
Это объявление входной функции программы. Программы на Dart всегда начинают выполняться с main().
Разберём это по частям:
| Часть | Значение |
|---|---|
| void | Тип возвращаемого значения. void означает "эта функция ничего не возвращает после выполнения." |
| main | Имя функции. Это принятое в Dart имя входной функции; его нельзя изменить на что-либо другое. |
| () | Список параметров. Здесь он пуст, то есть функция main не принимает параметров. |
| { | Начало тела функции. Оно образует пару с } в последней строке и охватывает весь код функции. |
main() — единственная точка входа Dart. Независимо от того, сколько файлов или классов в вашей программе, выполнение всегда начинается с первой строки main().
print('Hello, Dart!');
Это инструкция, которая выводит содержимое внутри круглых скобок в консоль.
Разберём это по частям:
| Часть | Значение |
|---|---|
| Имя встроенной функции, используемой для вывода строки текста в консоль. | |
| (...) | Список параметров вызова функции |
| 'Hello, Dart!' | Строковый литерал, заключённый в одинарные кавычки '. |
| ; | Терминатор инструкции. Каждая инструкция должна заканчиваться точкой с запятой. |
| Ведущие два пробела | Отступ, указывающий, что эта строка кода принадлежит функции main(). В Dart принято использовать 2 пробела для отступа. |
}
Закрывающий маркер тела функции main(), парный открывающей {.
Общая схема структуры
void main() { ← 函数签名(返回类型 + 函数名 + 参数)
print('Hello, ← 函数体:调用 print 函数
Dart!'); ← 传入字符串参数,以 ; 结尾
} ← 函数体结束
Два способа записи строк
В Dart строки можно заключать как в одинарные, так и в двойные кавычки; они полностью эквивалентны.
Пример
print('Hello, Dart!'); // Одинарные кавычки
print("Hello, Dart!"); // Двойные кавычки, тот же эффект
}
Hello, Dart! Hello, Dart!
Когда следует использовать какой тип кавычек? Можно руководствоваться следующими сценариями:
| Сценарии | Рекомендуется | Пример |
|---|---|---|
| Обычный случай | Одинарные кавычки (соглашение сообщества Dart) | 'Hello' |
| Строка содержит одинарные кавычки | Двойные кавычки | "It's a beautiful day!" |
| Строка содержит двойные кавычки | Одинарные кавычки | 'He said: "Hello"' |
Когда само содержимое строки содержит одинарные кавычки, обернуть её в двойные кавычки удобнее и позволяет избежать экранирования. Соглашение сообщества Dart предпочитает одинарные кавычки, и в дальнейшем в этом руководстве в основном будут использоваться одинарные кавычки.
Комментарии
Комментарии — это пояснительный текст, написанный для людей; компилятор Dart полностью их игнорирует.
Пример
// Это однострочный комментарий, от // до конца строки
print('Hello, Dart!'); // Можно также написать после инструкции
/*
Это многострочный комментарий.
Может занимать несколько строк,
Часто используется, чтобы временно закомментировать большой блок кода.
*/
/// Это документирующий комментарий, используемый для описания назначения функций, классов или переменных.
/// IDE отображают документирующие комментарии как всплывающие подсказки при наведении.
}
| Типы комментариев | Синтаксис | Назначение |
|---|---|---|
| Однострочный комментарий | // content | Объяснить строку кода |
| Многострочный комментарий | /* content */ | Закомментировать блок кода или написать более длинное пояснение |
| Документирующий комментарий | /// content | Для описания API и генерации документации |
Хорошие комментарии объясняют «почему», а не «что было сделано». Код сам уже показывает «что было сделано»; комментарии должны дополнять причину или намерение, стоящие за ним.
Переменные: именование данных
Программа не может выводить только фиксированный текст; нам нужны переменные для хранения и использования данных.
Пример
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" |
| int | Integer | 25、-10、0 |
| double | Десятичные числа (числа с плавающей точкой) | 1.68、3.14 |
| bool | Логическое значение (true/false) | true、false |
Подробности о типах данных будут рассмотрены в следующих главах; здесь мы лишь получим предварительное представление.
Используйте var для автоматического вывода типа
Немного утомительно каждый раз писать имя типа.
Dart поддерживает использование ключевого слова var для автоматического вывода типа переменной — компилятор определяет тип на основе присваиваемого вами значения.
Пример
var name = 'EXAMPLE'; // выводится как String
var age = 25; // выводится как int
var height = 1.68; // выводится как double
var isStudent = true; // выводится как bool
print(name);
print(age);
}
EXAMPLE 25
Тип, выведенный с помощью var, определяется во время компиляции; после этого вы не можете присвоить ему значение другого типа.
Пример
var name = 'EXAMPLE';
name = 'Bob'; // ОК, всё ещё String
// name = 123; // Ошибка: нельзя присвоить int переменной типа String
}
Когда следует использовать var, а когда нужно явно указывать тип?
| Сценарии | Рекомендуется | Причина |
|---|---|---|
| Локальные переменные, тип очевиден с первого взгляда | var | Более лаконично |
| Параметры функций, поля класса и возвращаемые типы. | Указывайте тип | Код становится понятнее и самодокументируемым |
Интерполяция строк: встраивание переменных в строки
Если вы хотите встроить значение переменной в строку, Dart предоставляет очень лаконичный синтаксис интерполяции строк — используйте $variableName или ${expression}.
Пример
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.
Чуть более полная небольшая программа
Теперь давайте объединим то, что мы изучили ранее, и напишем чуть более реалистичную программу: простой генератор самопрезентации.
Пример
// Личная информация
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 编程,很高兴认识大家!
=============================
Новый синтаксис: тернарный оператор
Пример
Это тернарный оператор Dart, записывается так:
condition ? value when the condition is true : value when the condition is false
Эквивалентно следующей форме if/else:
Пример
if (isStudent) {
occupation⟦⟧'Ютубер' = 'Student';
} else {
occupation = 'Профессионал';
}
Тернарный оператор очень лаконичен, когда у значения есть только две возможности. В следующих главах будет подробно рассказано о полном использовании if/else.
Стиль кода: написание на Dart.
Хороший стиль кода делает код более читаемым и профессиональным.
У Dart есть официальное руководство по стилю; на начальном этапе достаточно освоить следующие пункты.
Используйте 2 пробела для отступов
Пример
void main() {
print('Hello');
}
// Не рекомендуется: 4 пробела (распространено в других языках, но сообщество Dart предпочитает 2)
Имена переменных и функций используют lowerCamelCase (lowerCamelCase).
Пример
// var first_name = 'EXAMPLE'; // стиль с подчёркиванием: не соглашение Dart
// var FirstName = 'EXAMPLE'; // PascalCase: зарезервировано для имён классов
Имена классов используют UpperCamelCase.
Пример
// class user_profile { } // Неверно
// class userProfile { } // Неверно
Константы используют lower camel case (не всё заглавными буквами)
Пример
// const MAX_RETRIES = 3; // Это стиль C/Java, не рекомендуется в Dart
Используйте dart format для автоматического форматирования.
Вам не нужно запоминать правила; просто запустите в каталоге проекта:
$ dart format .
Официальный инструмент форматирования Dart автоматически приводит код к стандартному стилю; в VS Code также можно настроить автоматическое форматирование при сохранении.
Распространённые ошибки и пояснения
Новички часто сталкиваются со следующими ошибками при написании своей первой программы; давайте с ними ознакомимся.
Ошибка 1: Забытая точка с запятой
Пример
print('Hello, Dart!') // отсутствует ;
}
Сообщение об ошибке:
Error: Expected ';' after this.
Решение: добавьте ; в конце инструкции.
Ошибка 2: Несовпадающие круглые скобки
Пример
print('Hello, Dart!' // отсутствует закрывающая круглая скобка )
}
Сообщение об ошибке:
Error: Expected ')' before this.
Решение: внимательно проверьте, что каждой ( соответствует ). VS Code подсветит несовпадающие скобки.
Ошибка 3: несовпадающие кавычки строки
void main() {
print('Hello, Dart!"); // 一个单引号、一个双引号
}
Сообщение об ошибке:
Error: Unterminated string literal.
Решение: убедитесь, что оба конца строки используют один и тот же тип кавычек.
Ошибка 4: main написано с ошибкой
Пример
print('Hello, Dart!');
}
Dart чувствителен к регистру; Main и main — совершенно разные имена.
Программа компилируется, но во время выполнения выдаст ошибку:
Error: No 'main' method found.
Решение: входная функция должна быть main в нижнем регистре.
Ошибка 5: переменная используется до присваивания
Пример
String name;
print(name); // name не инициализирована
}
Ошибка null-safety в Dart:
Error: Non-nullable variable 'name' must be assigned before it can be used.
Решение: присвойте начальное значение при объявлении переменной или объявите её как nullable-тип String? name (подробнее в следующих главах).
Другие расширения