Sintaxis básica de Dart
Cada lenguaje de programación tiene su propio conjunto de reglas básicas, y Dart no es una excepción.
Este capítulo presenta la estructura básica de un programa Dart, la sintaxis de comentarios, la diferencia entre sentencias y expresiones, y las reglas de nomenclatura de identificadores.
Estructura del programa y la función main()
La extensión de los archivos Dart es.dartCada programa Dart debe tener un punto de entrada: la función main().
El programa comienza a ejecutarse desde la primera línea de la función main() y termina en la llave de la última línea.
Ejemplo
La estructura de un programa Dart mínimo:
void main() {
// Escribe tu código aquí
print('¡Bienvenido al tutorial de EJEMPLO Dart!');
}
欢迎来到 EJEMPLO Dart 教程!
Desglosemos cada parte de este código:
| Elemento de código | Descripción |
|---|---|
| void | Tipo de retorno; void indica que la función no devuelve ningún valor |
| main | Nombre de la función; este es el nombre de la función de entrada definido por Dart y no se puede cambiar |
| () | Lista de parámetros; main() puede no recibir parámetros, o puede recibir argumentos de línea de comandos |
| { } | Cuerpo de la función; el código entre llaves es lo que ejecuta la función |
| print() | Función incorporada, se utiliza para mostrar texto en la consola |
| ; | Terminador de sentencia; en Dart, cada sentencia debe terminar con un punto y coma |
Dart exige estrictamente que cada sentencia termine con un punto y coma (;). Olvidar el punto y coma es el error de sintaxis más común entre los principiantes. Afortunadamente, el complemento Dart de VS Code avisa automáticamente dónde falta el punto y coma.
La función main() con argumentos de línea de comandos
La función main() puede recibir una lista de cadenas como argumentos de línea de comandos:
Ejemplo
void main(List<String> args) {
// Muestra el número de argumentos
print('Número de argumentos: ${args.length}');
// Itera e imprime cada argumento
for (var i = 0; i < args.length; i++) {
print('Argumento $i: ${args[i]}');
}
}
$ dart run hello.dart ejemplo dart 教程 参数个数:3 参数 0: ejemplo 参数 1: dart 参数 2: 教程
Aquí se utilizan el tipo List y el bucle for, que explicaremos en detalle en capítulos posteriores.
Sintaxis de comentarios
Los comentarios son explicaciones del código; el compilador ignora su contenido.
Un buen comentario permite que otros (incluido tu yo de meses después) comprendan más rápido la intención del código.
Dart admite tres tipos de comentarios:
| Tipo | Sintaxis | Caso de uso |
|---|---|---|
| Comentario de una línea | // contenido del comentario | Explicación breve de la función de una línea de código |
| Comentario de varias líneas | /* contenido del comentario */ | Explicación detallada en varias líneas |
| Comentario de documentación | /// comentario de documentación | Genera documentación de API para funciones y clases |
Ejemplo
/// Los comentarios de documentación pueden generar documentación HTML con el comando [dart doc]
void main() {
// Comentario de una línea: muestra un mensaje de bienvenida
print('¡Bienvenido a aprender Dart!'); // Comentario en línea: esto también es válido
/*
* Comentario de varias líneas: adecuado para explicaciones largas
* Segunda línea del comentario
* Tercera línea del comentario
*/
print('Tutorial EJEMPLO - Sintaxis básica de Dart');
}
欢迎学习 Dart! EJEMPLO 教程 - Dart 基础语法
El principio de los comentarios es "explicar el porqué, no el qué". El código ya muestra qué hace; los comentarios deben explicar por qué se escribió así, o complementar información de contexto que el código no puede expresar.
Sentencias y expresiones
En Dart, el código se compone de sentencias (Statement) y expresiones (Expression).
Comprender la diferencia entre ambos te ayuda a organizar mejor la lógica del código.
Expresión (Expression)
Una expresión es un fragmento de código que puede evaluarse y produce un valor.
Ejemplo
// Cada una de las siguientes líneas es una expresión; todas producen un valor
42; // Expresión literal, valor 42
3 + 5; // Expresión aritmética, valor 8
'Hello'.length; // Expresión de acceso a propiedad, valor 5
(10 > 5); // Expresión relacional, valor true
}
Sentencia (Statement)
Una sentencia es una instrucción que ejecuta una acción; no produce un valor.
Ejemplo
// Sentencia de declaración de variable: declara una variable y le asigna un valor
var name = 'EJEMPLO';
// Sentencia de llamada a función: llama a print() para ejecutar una acción de salida
print(name);
// Sentencia de control de flujo: decide qué código ejecutar según una condición
if (name.length > 3) {
print('La longitud del nombre es mayor que 3');
}
}
EJEMPLO 名称长度大于 3
En resumen:Las expresiones producen valores; las sentencias ejecutan acciones.
Puedes usar expresiones donde se necesita un valor, pero no puedes usar sentencias.
Un error común es tratar todo el código como "sentencias". En realidad, muchas construcciones en Dart (como las llamadas a funciones y la asignación de variables) son en sí mismas expresiones, lo que significa que se pueden anidar. Esta es una característica común de Dart y otros lenguajes de la familia C.
Reglas de nomenclatura de identificadores
Un identificador (Identifier) es el nombre que das a elementos de código como variables, funciones, clases, etc.
Dart tiene algunas reglas y convenciones para los identificadores:
Reglas de nomenclatura (obligatorias)
Los identificadores solo pueden estar compuestos por letras, números, guiones bajos (_) y el símbolo de dólar ($).
Los identificadores no pueden comenzar con un número.
Los identificadores no pueden ser palabras clave reservadas de Dart (como class, if, var, etc.).
Convenciones de nomenclatura (recomendadas)
| Elemento de código | Estilo de nomenclatura | Ejemplo |
|---|---|---|
| Nombre de clase | UpperCamelCase | StudentInfo、HttpClient |
| Tipo enumerado | UpperCamelCase | Color、Status |
| Nombre de librería, nombre de archivo | Minúsculas con guiones bajos (lowercase_with_underscores) | my_utils、user_service |
| Nombre de variable | lowerCamelCase | userName、maxCount |
| Nombre de función | lowerCamelCase | getUserInfo()、calculateTotal() |
| Nombre de constante | lowerCamelCase | piValue、defaultPort |
| Miembros privados | Prefijo de guion bajo | _internalState、_privateMethod() |
Ejemplo
Aplicación práctica de los distintos estilos de nomenclatura:
class UserAccount {
// Miembros públicos: lowerCamelCase
String userName;
// Miembros privados: prefijo de guion bajo (solo accesibles dentro de este archivo)
String _password;
// Constructor
UserAccount(this.userName, this._password);
// Métodos públicos: lowerCamelCase
bool verifyPassword(String input) {
return input == _password;
}
// Métodos privados: prefijo de guion bajo
void _encryptPassword() {
// Lógica de cifrado...
}
}
// Función de entrada: minúsculas
void main() {
// Nombre de variable: lowerCamelCase
var userAccount = UserAccount('ejemplo', '123456');
// Constante: lowerCamelCase (estilo Dart)
const maxLoginAttempts = 3;
print('Nombre de usuario: ${userAccount.userName}');
print('Número máximo de intentos de inicio de sesión: $maxLoginAttempts');
}
用户名: ejemplo 最大登录尝试次数: 3
En las convenciones de nomenclatura de Dart, las constantes usan lowerCamelCase, en lugar del estilo común en otros lenguajes de MAYÚSCULAS con guiones bajos (UPPER_CASE). Este es un estilo distintivo de la comunidad de Dart, tenlo en cuenta.
