Le premier programme Dart

Apprendre un langage de programmation — la meilleure façon n'est pas de mémoriser d'abord les règles de grammaire, mais de faire fonctionner un programme, puis de se demander, ligne par ligne, ce que cela signifie.

Dans ce chapitre, nous commencerons par le programme le plus simple et l'étendrons progressivement en un petit programme un peu plus complet, en parcourant au passage les concepts les plus élémentaires de Dart.

Extension de fichier standard du langage Dart.dart, par exemplehello.dart。


Le programme le plus simple : Hello, Dart!

Ouvrez DartPadhttps://dartpad.dev(ou créez un fichier hello.dart dans un éditeur local), saisissez le code suivant :

Exemple

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

Cliquez sur Exécuter, sortie :

Hello, Dart!

Commande à exécuter dans l'environnement local :

dart hello.dart

Seulement ces 3 lignes de code. Maintenant, comprenons chaque caractère.


Analyse ligne par ligne

void main() {

Ceci est la déclaration de la fonction d'entrée du programme. Les programmes Dart commencent toujours leur exécution à partir de main().

Décomposons-le :

PartieSignification
voidType de retour. void signifie "cette fonction ne renvoie rien après exécution."
mainNom de la fonction. C'est le nom conventionnel de la fonction d'entrée en Dart ; il ne peut pas être changé.
()Liste des paramètres. Elle est vide ici, ce qui signifie que la fonction main n'accepte aucun paramètre.
{Le début du corps de la fonction. Il s'associe au } de la dernière ligne et englobe tout le code de la fonction.

main() est le seul point d'entrée de Dart. Peu importe le nombre de fichiers ou de classes de votre programme, l'exécution commence toujours à la première ligne de main().

print('Hello, Dart!');

C'est une instruction qui affiche le contenu entre parenthèses dans la console.

Décomposons-le :

PartieSignification
printNom de fonction intégrée, utilisé pour afficher une ligne de texte dans la console.
(...)Liste des paramètres d'un appel de fonction
'Hello, Dart!'Un littéral de chaîne, entouré de guillemets simples '.
;Terminateur d'instruction. Chaque instruction doit se terminer par un point-virgule.
Les deux espaces initiauxIndentation, indiquant que cette ligne de code se trouve à l'intérieur de la fonction main(). La convention Dart utilise 2 espaces pour l'indentation.

}

Le marqueur de fermeture du corps de la fonction main(), associé à l'accolade ouvrante {.

Schéma de la structure globale

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

Deux façons d'écrire des chaînes de caractères

En Dart, les chaînes de caractères peuvent être entourées de guillemets simples ou de guillemets doubles ; elles sont complètement équivalentes.

Exemple

void main() {
  print('Hello, Dart!');   // Guillemets simples
  print("Hello, Dart!");   // Guillemets doubles, même effet
}
Hello, Dart!
Hello, Dart!

Quand devez-vous utiliser quel type de guillemet ? Vous pouvez vous référer aux scénarios suivants :

ScénariosRecommandéExemple
Cas normalGuillemets simples (convention de la communauté Dart)'Hello'
La chaîne contient des guillemets simplesGuillemets doubles"It's a beautiful day!"
La chaîne contient des guillemets doublesGuillemets simples'He said: "Hello"'

Lorsque le contenu de la chaîne contient lui-même des guillemets simples, l'encadrer par des guillemets doubles est plus pratique et évite l'échappement. La convention de la communauté Dart privilégie les guillemets simples, et ce tutoriel utilisera principalement des guillemets simples par la suite.


Commentaires

Les commentaires sont du texte explicatif écrit pour les humains ; le compilateur Dart les ignore complètement.

Exemple

void main() {
  // Ceci est un commentaire sur une seule ligne, de // jusqu'à la fin de la ligne
  print('Hello, Dart!'); // Peut aussi être écrit après une instruction

  /*
Ceci est un commentaire multiligne.
Peut s'étendre sur plusieurs lignes,
Souvent utilisé pour mettre temporairement en commentaire un grand bloc de code.
  */


  /// Ceci est un commentaire de documentation, utilisé pour décrire l'objectif des fonctions, des classes ou des variables.
  /// Les IDE affichent les commentaires de documentation sous forme d'infobulles au survol.
}
Types de commentairesSyntaxeObjectif
Commentaire sur une ligne// contentExpliquer une ligne de code
Commentaire multiligne/* content */Mettre en commentaire un bloc de code, ou écrire une explication plus longue
Commentaire de documentation/// contentPour décrire des API et générer de la documentation

Les bons commentaires expliquent « pourquoi », pas « ce qui a été fait ». Le code lui-même montre déjà « ce qui a été fait » ; les commentaires doivent compléter la raison ou l'intention sous-jacente.


Variables : nommer des données

Un programme ne peut pas seulement afficher du texte fixe ; nous avons besoin de variables pour stocker et utiliser des données.

Exemple

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 de déclaration de variable

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

Aperçu rapide des types de données de base

TypeDescriptionExemple
StringChaîne de texte'EXAMPLE'、"hello"
intInteger25、-10、0
doubleNombres décimaux (nombres à virgule flottante)1.68、3.14
boolValeur booléenne (true/false)true、false

Les détails des types de données seront abordés dans les chapitres suivants ; ici, nous ne faisons qu'un premier aperçu.


Utiliser var pour déduire automatiquement le type

C'est un peu fastidieux d'écrire le nom du type à chaque fois.

Dart prend en charge l'utilisation du mot-clé var pour déduire automatiquement le type de la variable — le compilateur détermine le type en fonction de la valeur que vous affectez.

Exemple

void main() {
  var name = 'EXAMPLE';    // déduit comme String
  var age = 25;           // déduit comme int
  var height = 1.68;      // déduit comme double
  var isStudent = true;   // déduit comme bool

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

Le type déduit par var est déterminé au moment de la compilation ; après cela, vous ne pouvez pas lui affecter une valeur d'un type différent.

Exemple

void main() {
  var name = 'EXAMPLE';
  name = 'Bob';    // OK, toujours String
  // name = 123; // Erreur : impossible d'affecter un int à une variable de type String
}

Quand faut-il utiliser var, et quand faut-il écrire explicitement le type ?

ScénariosRecommandéRaison
Variables locales, le type est évident au premier coup d'œilvarPlus concis
Paramètres de fonction, champs de classe et types de retour.Spécifier le typeLe code est plus clair et auto-documenté

Interpolation de chaînes : intégrer des variables dans des chaînes

Si vous voulez intégrer la valeur d'une variable dans une chaîne, Dart fournit une syntaxe d'interpolation de chaînes très concise—utilisez $variableName ou ${expression}.

Exemple

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

  print('Je m'appelle $name, et j'ai $age ans.');
  print('L’année prochaine, j’aurai ${age + 1} ans.');
}
我叫 EXAMPLE,今年 25 岁。
明年我将 26 岁。
SyntaxeObjectifExemple
$variableNameIncorporer directement les valeurs des variables, de façon concise$name
${expression}Incorporer n’importe quelle expression (calcul, appel de méthode, etc.).${age + 1}、${name.toUpperCase()}

Comparée à la concaténation de chaînes comme print('My name is ' + name + ', this year ' + age.toString() + ' years old.'), la syntaxe d’interpolation est plus claire, plus sûre et constitue le style idiomatique en Dart.


Un petit programme un peu plus complet

Maintenant, combinons ce que nous avons appris précédemment et écrivons un programme un peu plus réaliste : un simple générateur de présentation personnelle.

Exemple

void main() {
  // Informations personnelles
  var name = 'EXAMPLE';
  var age = 25;
  var city = 'Shanghai';
  var isStudent = false;
  var hobby = 'programmation Dart';

  // Générer l'introduction : l'opérateur ternaire détermine l'identité
  var occupation = isStudent ? 'étudiant' : 'professionnel';

  print('=============================');
  print(' Profil personnel');
  print('=============================');
  print('Nom : $name');
  print('Âge : $age');
  print('Ville : $city');
  print('Identité : $occupation');
  print('Loisir : $hobby');
  print('-----------------------------');
  print('Bonjour tout le monde, je suis $name de $city,');
  print('J'ai $age ans cette année, et je suis $occupation.');
  print('Mon passe-temps est ${hobby}, ravi de vous rencontrer tous !');
  print('=============================');
}
=============================
       个人简介
=============================
姓名:EXAMPLE
年龄:25 岁
城市:上海
身份:职场人
爱好:Dart 编程
-----------------------------
大家好,我是来自上海的EXAMPLE,
今年 25 岁,是一名职场人。
我的爱好是Dart 编程,很高兴认识大家!
=============================

Nouvelle syntaxe : opérateur ternaire

Exemple

var occupation = isStudent ? 'étudiant' : 'professionnel';

Voici l'opérateur ternaire de Dart, formaté comme suit :

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

Équivalent à la forme if/else suivante :

Exemple

String occupation;
if (isStudent) {
  occupation = 'Étudiant';
} else {
  occupation = 'Professionnel';
}

L'opérateur ternaire est très concis lorsqu'une valeur n'a que deux possibilités. Les chapitres suivants présenteront en détail l'utilisation complète de if/else.


Style de code : conventions d'écriture Dart.

Un bon style de code rend le code plus lisible et professionnel.

Dart dispose d'un guide de style officiel recommandé ; au niveau débutant, maîtriser les points suivants suffit.

Utilisez 2 espaces pour l'indentation

Exemple

// Correct : 2 espaces
void main() {
  print('Hello');
}

// Non recommandé : 4 espaces (courant dans d'autres langages, mais la communauté Dart préfère 2)

Les noms de variables et de fonctions utilisent lowerCamelCase (lowerCamelCase).

Exemple

var firstName = 'EXAMPLE';     // lower camel case : correct
// var first_name = 'EXAMPLE'; // style avec underscore : non conforme aux conventions Dart
// var FirstName = 'EXAMPLE'; // PascalCase : réservé aux noms de classes

Les noms de classes utilisent UpperCamelCase.

Exemple

class⟦⟧UserProfile UserProfile { }   // correct
// class user_profile { } // Incorrect
// class userProfile { } // Incorrect

Les constantes utilisent le lower camel case (pas tout en majuscules)

Exemple

const maxRetries = 3;       // Convention Dart : correcte
// const MAX_RETRIES = 3; // C'est le style C/Java, non recommandé en Dart

Utilisez dart format pour formater automatiquement.

Vous n'avez pas besoin de mémoriser les règles ; exécutez simplement dans le répertoire du projet :

$ dart format .

L'outil de formatage officiel de Dart ajuste automatiquement le code au style standard ; dans VS Code, vous pouvez également configurer le formatage automatique lors de l'enregistrement.


Erreurs courantes et explications

Les débutants rencontrent souvent les erreurs suivantes lorsqu'ils écrivent leur premier programme ; familiarisons-nous avec elles.

Erreur 1 : Oubli du point-virgule

Exemple

void main() {
  print('Hello, Dart!')  // point-virgule manquant
}

Message d'erreur :

Error: Expected ';' after this.

Solution : ajoutez ; à la fin de l'instruction.

Erreur 2 : Parenthèses non appariées

Exemple

void main() {
  print('Hello, Dart!'   // 缺少右括号 )
}

Message d'erreur :

Error: Expected ')' before this.

解决方案: 仔细检查每个 ( 是否都有对应的 ). VS Code 会高亮显示不匹配的括号.

错误 3: 字符串引号不匹配

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

Message d'erreur :

Error: Unterminated string literal.

解决方案: 确保字符串两端使用相同类型的引号.

错误 4: main 拼写错误

Exemple

void Main() {  // M 是大写的
  print('Hello, Dart!');
}

Dart 区分大小写; Main 和 main 完全不同.

程序可以编译, 但会在运行时报告错误:

Error: No 'main' method found.

解决方案: 入口函数必须是小写的 main.

错误 5: 变量在赋值前被使用

Exemple

void main() {
  String name;
  print(name);  // name 未初始化
}

Dart 空安全错误:

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

Solution : attribuez une valeur initiale lors de la déclaration de la variable, ou déclarez-la comme un type nullable String? name (détaillé dans les chapitres suivants).

autres extensions