Skip to content

2. Configuración de un entorno de desarrollo

Nota: en los pasos siguientes usaremos la herramienta VSCode para probar los scripts Dart. Abra dos ventanas de VSCode y use [File / Open Folder] para abrir las carpetas de ambos proyectos.

El curso de TypeScript instala Node.js, un proyecto npm ([package.json]), TypeScript y su verificador de tipos ([tsc]), un ejecutor de scripts que no requiere compilación previa ([tsx]) y, por último, ESLint. El equivalente en Dart de toda esta cadena de herramientas consiste en un único componente por instalar: el [Dart SDK], que puede descargarse desde [dart.dev] o, más sencillamente, instalarse mediante un administrador de paquetes del sistema ([choco install dart-sdk] en Windows, [brew install dart] en macOS, o el repositorio oficial de APT en Linux/Debian/Ubuntu).

Mientras que TypeScript requiere tres herramientas separadas (el compilador [tsc] para verificar los tipos, [tsx] para ejecutar un script sin compilarlo antes y ESLint para el análisis de estilo), el SDK de Dart ofrece todo esto en un único comando, [dart], que incluye los siguientes subcomandos: [dart run] (ejecuta un script), [dart analyze] (verifica el estilo; el equivalente combinado de [tsc] y ESLint), [dart pub] (administra las dependencias, equivalente a [npm]), [dart format] (reformatea el código, equivalente a Prettier) y [dart test] (ejecuta las pruebas).

2.1. Verificación de las herramientas instaladas

Una vez instalado el SDK, verifique la instalación en una terminal de VSCode:

PS C:\Data\st-2026\dev\dart\dart-sept-2026-scripts\dart-fundamentals> dart --version
Dart SDK version: 3.12.2 (stable) (Tue Jun 9 01:11:39 2026 -0700) on "windows_x64"

que muestra la versión del SDK (por ejemplo, [Dart SDK version: 3.12.2 (stable)]). A diferencia de Node.js y TypeScript, que se instalan por separado (una versión de Node, una versión de TypeScript), el número de versión del SDK de Dart abarca el lenguaje, el compilador y todas las herramientas controladas por [dart]: solo hay una versión que seguir.

2.2. Configuración del proyecto en VSCode

Como con TypeScript, cree una carpeta de proyecto y ábrala en VSCode. Mientras que un proyecto TypeScript se declara con dos archivos ([package.json] para las dependencias, [tsconfig.json] para las opciones del compilador), un proyecto Dart requiere solo uno: [pubspec.yaml].

2.2.1. El archivo pubspec.yaml

[pubspec.yaml] cumple a la vez el papel de [package.json] (nombre del proyecto, dependencias) y, en menor medida, el de [tsconfig.json] (la clave [environment: sdk:] fija el rango de versiones aceptadas del SDK de Dart, de forma similar a como [target]/[lib] definen la versión de ECMAScript que [tsc] tiene como objetivo):

1
2
3
4
5
6
7
8
9
name: dart_fundamentals
description: Scripts of the course "Introduction to the Dart language by example"
publish_to: 'none'
environment:
  sdk: '>=3.3.0 <4.0.0'

dependencies:
  http: ^1.2.0
  dio: ^5.4.0

A diferencia de [package.json] (en formato JSON), [pubspec.yaml] es, estrictamente hablando, un archivo YAML: en él la sangría es significativa, igual que en Python.

Una vez escrito este archivo, el comando [dart pub get] (equivalente a [npm install]) descarga las dependencias declaradas y genera un archivo [pubspec.lock] (equivalente a [package-lock.json]), que fija las versiones exactas por instalar.

2.3. Primer script

Un script Dart mínimo, [hello.dart]:

1
2
3
void main() {
  print('Hello Dart!');
}

se ejecuta con:

dart run hello.dart

Dos diferencias inmediatas respecto del primer script TypeScript del curso: la función [main] es aquí OBLIGATORIA (un script Dart ejecutable debe definir una función llamada [main] a nivel de archivo, a diferencia de TypeScript/[tsx], donde el código de nivel superior del archivo se ejecuta directamente, sin requerir que se defina una función); y [dart run] compila y ejecuta el script en un solo paso, sin un paso de transpilación separado visible (como [tsx], pero sin necesidad de instalar ninguna herramienta adicional: [dart run] forma parte del propio SDK).

2.4. Segundo script: análisis estático

Mientras que el curso de TypeScript distingue entre un paso de “verificación de tipos” ([tsc --noEmit]) y un paso separado de ESLint, Dart fusiona ambos en un solo comando:

dart analyze

Cuando se ejecuta sin argumentos desde la raíz de un proyecto que contiene un archivo [pubspec.yaml], analiza todos los archivos [.dart] del proyecto: señala tanto los errores de tipo (el equivalente de [tsc]) como los problemas de estilo cubiertos por las reglas de lint habilitadas (el equivalente de ESLint); véase la sección siguiente para saber cómo habilitar estas reglas.

2.5. El linter

ESLint es una herramienta externa que debe instalarse y configurarse por separado (archivo [eslint.config.js], selección de un preset, etc.). Dart integra su propio linter directamente en [dart analyze]: basta con agregar el paquete oficial [package:lints] a las [dev_dependencies] de [pubspec.yaml] y luego crear un archivo [analysis_options.yaml] en la raíz del proyecto:

include: package:lints/recommended.yaml

Este único archivo cumple la misma función que [eslint.config.js] en el curso de TypeScript: activa un conjunto de reglas recomendadas por el equipo de Dart (variables sin usar, comparaciones sospechosas, preferencia por [const], etc.), que [dart analyze] aplica luego automáticamente.

2.6. Extensión de Dart para VSCode

La extensión oficial [Dart] (editor: Dart Code), instalada desde el marketplace de extensiones de VSCode, cumple exactamente la misma función que la extensión de ESLint del curso de TypeScript, pero es más completa: resaltado de sintaxis, autocompletado, visualización de los errores de [dart analyze] directamente en el editor y ejecución de scripts (el botón [Run]/[Debug] sobre cada función [main]) sin salir de VSCode. Instalar esta única extensión basta para cubrir lo que el curso de TypeScript reparte entre varias extensiones.