Das erste Dart-Programm

Eine Programmiersprache zu lernen – der beste Weg ist nicht, zuerst Grammatikregeln auswendig zu lernen, sondern ein Programm zum Laufen zu bringen und dann Zeile für Zeile zu fragen, was es bedeutet.

In diesem Kapitel beginnen wir mit dem einfachsten Programm und erweitern es nach und nach zu einem etwas vollständigeren kleinen Programm, wobei wir unterwegs die grundlegendsten Konzepte von Dart durchgehen.

Standard-Dateiendung der Sprache Dart.dart, zum Beispielhello.dart。


Das einfachste Programm: Hello, Dart!

DartPad öffnenhttps://dartpad.dev(oder eine Datei hello.dart in einem lokalen Editor erstellen), folgenden Code eingeben:

Beispiel

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

Auf Ausführen klicken, Ausgabe:

Hello, Dart!

Befehl zum Ausführen in der lokalen Umgebung:

dart hello.dart

Nur diese 3 Codezeilen. Jetzt wollen wir jedes Zeichen verstehen.


Zeilenweise Analyse

void main() {

Dies ist die Deklaration der Einstiegsfunktion des Programms. Dart-Programme beginnen die Ausführung immer bei main().

Zerlegen wir es:

TeilBedeutung
voidRückgabetyp. void bedeutet "diese Funktion gibt nach der Ausführung nichts zurück."
mainFunktionsname. Dies ist der in Dart übliche Name der Einstiegsfunktion; er darf nicht anders benannt werden.
()Parameterliste. Sie ist hier leer, was bedeutet, dass die main-Funktion keine Parameter entgegennimmt.
{Der Beginn des Funktionskörpers. Er stellt das Gegenstück zum } in der letzten Zeile dar und umschließt den gesamten Code der Funktion.

main() ist der einzige Einstiegspunkt von Dart. Egal, wie viele Dateien oder Klassen Ihr Programm hat, die Ausführung beginnt immer in der ersten Zeile von main().

print('Hello, Dart!');

Dies ist eine Anweisung, die den Inhalt innerhalb der Klammern auf der Konsole ausgibt.

Zerlegen wir es:

TeilBedeutung
printName einer eingebauten Funktion, mit der eine Textzeile auf der Konsole ausgegeben wird.
(...)Parameterliste eines Funktionsaufrufs
'Hello, Dart!'Ein String-Literal, eingeschlossen in einfache Anführungszeichen '.
;Anweisungsabschluss. Jede Anweisung muss mit einem Semikolon enden.
Die führenden zwei LeerzeichenEinrückung, die anzeigt, dass diese Codezeile zur main()-Funktion gehört. Die Dart-Konvention verwendet 2 Leerzeichen zur Einrückung.

}

Die schließende Markierung des main()-Funktionskörpers, gepaart mit der öffnenden {.

Gesamtstrukturdiagramm

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

Zwei Möglichkeiten, Strings zu schreiben

In Dart können Strings entweder in einfache Anführungszeichen oder in doppelte Anführungszeichen gesetzt werden; sie sind völlig gleichwertig.

Beispiel

void main() {
  print('Hello, Dart!');   // Einfache Anführungszeichen
  print("Hello, Dart!");   // Doppelte Anführungszeichen, gleicher Effekt
}
Hello, Dart!
Hello, Dart!

Wann solltest du welche Art von Anführungszeichen verwenden? Du kannst dich an den folgenden Szenarien orientieren:

SzenarienEmpfohlenBeispiel
NormalfallEinfache Anführungszeichen (Dart-Community-Konvention)'Hello'
String enthält einfache AnführungszeichenDoppelte Anführungszeichen"It's a beautiful day!"
String enthält doppelte AnführungszeichenEinfache Anführungszeichen'He said: "Hello"'

Wenn der String-Inhalt selbst einfache Anführungszeichen enthält, ist es bequemer, ihn in doppelte Anführungszeichen zu setzen, und das vermeidet Escaping. Die Konvention der Dart-Community bevorzugt einfache Anführungszeichen, und dieses Tutorial wird im Folgenden hauptsächlich einfache Anführungszeichen verwenden.


Kommentare

Kommentare sind erklärender Text, der für Menschen geschrieben wurde; der Dart-Compiler ignoriert sie vollständig.

Beispiel

void main() {
  // Dies ist ein einzeiliger Kommentar, von // bis zum Zeilenende
  print('Hello, Dart!'); // Kann auch nach einer Anweisung geschrieben werden

  /*
Dies ist ein mehrzeiliger Kommentar.
Kann sich über mehrere Zeilen erstrecken,
Wird oft verwendet, um vorübergehend einen großen Codeblock auszukommentieren.
  */


  /// Dies ist ein Dokumentationskommentar, der den Zweck von Funktionen, Klassen oder Variablen beschreibt.
  /// IDEs zeigen Dokumentationskommentare als Hover-Tooltips an.
}
KommentartypenSyntaxZweck
Einzeiliger Kommentar// InhaltEine Codezeile erklären
Mehrzeiliger Kommentar/* Inhalt */Einen Codeblock auskommentieren oder eine längere Erklärung schreiben
Dokumentationskommentar/// InhaltZum Beschreiben von APIs und Generieren von Dokumentation

Gute Kommentare erklären "warum", nicht "was gemacht wurde". Der Code selbst zeigt bereits "was gemacht wurde"; Kommentare sollten den Grund oder die Absicht dahinter ergänzen.


Variablen: Daten benennen

Ein Programm kann nicht nur festen Text ausgeben; wir brauchen Variablen, um Daten zu speichern und zu verwenden.

Beispiel

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

Format der Variablendeklaration

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

Kurzer Überblick über grundlegende Datentypen

TypeBeschreibungBeispiel
StringTextzeichenfolge'EXAMPLE'、"hello"
intInteger25、-10、0
doubleDezimalzahlen (Gleitkommazahlen)1.68、3.14
boolBoolescher Wert (true/false)true, false

Die Details zu Datentypen werden in späteren Kapiteln behandelt; hier erhalten wir nur einen ersten Eindruck.


Verwende var, um den Typ automatisch abzuleiten

Es ist etwas mühsam, jedes Mal den Typnamen zu schreiben.

Dart unterstützt die Verwendung des var-Schlüsselworts, um den Variablentyp automatisch abzuleiten – der Compiler bestimmt den Typ anhand des zugewiesenen Werts.

Beispiel

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

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

Der von var abgeleitete Typ wird zur Kompilierzeit bestimmt; danach kann ihm kein Wert eines anderen Typs zugewiesen werden.

Beispiel

void main() {
  var name = 'EXAMPLE';
  name = 'Bob';    // OK, weiterhin String
  // name = 123; // Fehler: int kann nicht einer Variablen vom Typ String zugewiesen werden
}

Wann sollten Sie var verwenden und wann den Typ explizit angeben?

SzenarienEmpfohlenGrund
Lokale Variablen, der Typ ist auf einen Blick ersichtlichvarPrägnanter
Funktionsparameter, Klassenfelder und Rückgabetypen.Typ angebenCode ist klarer und selbstdokumentierend

String-Interpolation: Einbetten von Variablen in Strings

Wenn Sie den Wert einer Variablen in einen String einbetten möchten, bietet Dart eine sehr prägnante String-Interpolationssyntax – verwenden Sie $variableName oder ${expression}.

Beispiel

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

  print('Mein Name ist $name, und ich bin $age Jahre alt.');
  print('Nächstes Jahr werde ich ${age + 1} Jahre alt sein.');
}
我叫 EXAMPLE,今年 25 岁。
明年我将 26 岁。
SyntaxZweckBeispiel
$variableNameVariablenwerte direkt einbetten, kurz und prägnant$name
${expression}Beliebige Ausdrücke einbetten (Berechnung, Methodenaufruf usw.).${age + 1}、${name.toUpperCase()}

Im Vergleich zur String-Verkettung wie print('Mein Name ist ' + name + ', dieses Jahr ' + age.toString() + ' Jahre alt.'), ist die Interpolationssyntax klarer, sicherer und der idiomatische Stil in Dart.


Ein etwas vollständigeres kleines Programm

Jetzt kombinieren wir, was wir zuvor gelernt haben, und schreiben ein etwas realistischeres Programm: einen einfachen Selbstvorstellungsgenerator.

Beispiel

void main() {
  // Persönliche Informationen
  var name = 'EXAMPLE';
  var age = 25;
  var city = 'Shanghai';
  var isStudent = false;
  var hobby = 'Dart-Programmierung';

  // Einleitung generieren: Der ternäre Operator bestimmt die Identität
  var occupation = isStudent ? 'Student' : 'Berufstätiger';

  print('=============================');
  print(' Persönliches Profil');
  print('=============================');
  print('Name: $name');
  print('Alter: $age');
  print('Stadt: $city');
  print('Identität: $occupation');
  print('Hobby: $hobby');
  print('-----------------------------');
  print('Hallo zusammen, ich bin $name aus $city,');
  print('Ich bin dieses Jahr $age Jahre alt und ich bin $occupation.');
  print('My hobby is ${hobby}, nice to meet you all!');
  print('=============================');
}
=============================
       个人简介
=============================
姓名:EXAMPLE
年龄:25 岁
城市:上海
身份:职场人
爱好:Dart 编程
-----------------------------
大家好,我是来自上海的EXAMPLE,
今年 25 岁,是一名职场人。
我的爱好是Dart 编程,很高兴认识大家!
=============================

Neue Syntax: Ternärer Operator

Beispiel

var occupation = isStudent ? 'Student' : 'Berufstätiger';

Dies ist Darts ternärer Operator, formatiert als:

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

Entspricht der folgenden if/else-Form:

Beispiel

String occupation;
if (isStudent) {
  occupation = 'Student';
} else {
  occupation = 'Professional';
}

Der ternäre Operator ist sehr prägnant, wenn ein Wert nur zwei Möglichkeiten hat. Spätere Kapitel werden die vollständige Verwendung von if/else im Detail vorstellen.


Code-Stil: Dart-Schreibkonventionen.

Ein guter Code-Stil macht Code lesbarer und professioneller.

Dart hat einen offiziellen empfohlenen Styleguide; in der Anfängerphase genügt es, die folgenden Punkte zu beherrschen.

Verwende 2 Leerzeichen für die Einrückung

Beispiel

// Korrekt: 2 Leerzeichen
void main() {
  print('Hello');
}

// Nicht empfohlen: 4 Leerzeichen (in anderen Sprachen üblich, aber die Dart-Community bevorzugt 2)

Variablen- und Funktionsnamen verwenden lowerCamelCase (lowerCamelCase).

Beispiel

var firstName = 'EXAMPLE';     // lower camel case: korrekt
// var first_name = 'EXAMPLE'; // Unterstrich-Stil: keine Dart-Konvention
// var FirstName = 'EXAMPLE'; // PascalCase: für Klassennamen reserviert

Klassennamen verwenden UpperCamelCase.

Beispiel

class UserProfile { }   // korrekt
// class user_profile { } // Falsch
// class userProfile { } // Falsch

Konstanten verwenden Lower Camel Case (nicht alles in Großbuchstaben)

Beispiel

const maxRetries = 3;       // Dart-Konvention: korrekt
// const MAX_RETRIES = 3; // Dies ist C/Java-Stil, in Dart nicht empfohlen

Verwende dart format, um automatisch zu formatieren.

Du musst die Regeln nicht auswendig lernen; führe es einfach im Projektverzeichnis aus:

$ dart format .

Darts offizielles Formatierungstool passt den Code automatisch an den Standardstil an; in VS Code kannst du außerdem die automatische Formatierung beim Speichern konfigurieren.


Häufige Fehler und Erklärungen

Anfänger stoßen beim Schreiben ihres ersten Programms oft auf die folgenden Fehler; machen wir uns mit ihnen vertraut.

Fehler 1: Das Semikolon vergessen

Beispiel

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

Fehlermeldung:

Error: Expected ';' after this.

Lösung: Füge ; am Ende der Anweisung hinzu.

Fehler 2: Nicht übereinstimmende Klammern

Beispiel

void main() {
  print('Hello, Dart!'   // fehlende schließende Klammer )
}

Fehlermeldung:

Error: Expected ')' before this.

Lösung: Prüfe sorgfältig, dass jede ( eine entsprechende ) hat. VS Code hebt nicht übereinstimmende Klammern hervor.

Fehler 3: Nicht übereinstimmende String-Anführungszeichen

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

Fehlermeldung:

Error: Unterminated string literal.

Lösung: Stelle sicher, dass beide Enden des Strings dieselbe Art von Anführungszeichen verwenden.

Fehler 4: main falsch geschrieben

Beispiel

void Main() {  // M ist großgeschrieben
  print('Hello, Dart!');
}

Dart unterscheidet zwischen Groß- und Kleinschreibung; Main und main sind völlig unterschiedliche Namen.

Das Programm kompiliert, aber zur Laufzeit wird ein Fehler gemeldet:

Error: No 'main' method found.

Lösung: Die Einstiegsfunktion muss main in Kleinbuchstaben sein.

Fehler 5: Variable verwendet, bevor sie zugewiesen wurde

Beispiel

void main() {
  String name;
  print(name);  // name ist nicht initialisiert
}

Dart-Null-Safety-Fehler:

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

Lösung: Weisen Sie der Variablen beim Deklarieren einen Anfangswert zu oder deklarieren Sie sie als nullbaren Typ String? name (detailliert in späteren Kapiteln).

Weitere Erweiterungen