---
title: "Instalar Flutter en Windows y solucionar los errores de flutter doctor"
description: "Cómo instalar Flutter en Windows paso a paso: descargar el SDK, configurar el PATH y Android Studio, y solucionar los errores habituales de flutter doctor."
url: "https://arbabnaseer.com/es/articulos/instalar-flutter-windows-flutter-doctor/"
lang: "es"
author: "Arbab Naseer"
datePublished: "2026-10-11T00:00:00+05:00"
dateModified: "2026-10-11T00:00:00+05:00"
tags: "Flutter, Windows, flutter doctor, Android Studio, Dart"
---

# Instalar Flutter en Windows y solucionar los errores de flutter doctor

> Cómo instalar Flutter en Windows paso a paso: descargar el SDK, configurar el PATH y Android Studio, y solucionar los errores habituales de flutter doctor.

Arbab Naseer · 2026-10-11 · https://arbabnaseer.com/es/articulos/instalar-flutter-windows-flutter-doctor/

**Respuesta corta:** instala Git para Windows, descarga el zip del SDK de Flutter para Windows (o deja que lo descargue VS Code), extráelo en una ruta sencilla como `C:\Users\<tu-usuario>\develop\flutter`, añade la carpeta `flutter\bin` al PATH de tu usuario, abre una terminal nueva y ejecuta `flutter doctor`. Después instala Android Studio y las herramientas de línea de comandos del Android SDK, y acepta las licencias con `flutter doctor --android-licenses`.

Esta guía sigue la configuración que uso en mi propio trabajo con Flutter, incluido [PocketPOS](https://arbabnaseer.com/es/proyectos/pocketpos-app-punto-de-venta-facturacion-khata/), y cubre los errores que más veo cuando ayudo a otros desarrolladores a empezar. Está escrita para Flutter 3.47, la versión estable actual en octubre de 2026, pero los pasos apenas cambian entre versiones.

## Qué necesitas antes de instalar Flutter

Necesitas un PC con Windows 10 o Windows 11 de 64 bits, unos 10 GB de espacio libre para Flutter y las herramientas de Android, y **Git para Windows**. Flutter usa Git para gestionar sus propias versiones, así que `flutter doctor` falla sin él.

Android Studio solo hace falta para compilar para Android, y Visual Studio solo para apps de escritorio de Windows.

Instala Git desde git-scm.com con las opciones por defecto y compruébalo en una ventana nueva de PowerShell:

```powershell
git --version
```

## Paso 1: descargar el SDK de Flutter para Windows

Hay dos buenas formas de conseguir el SDK. Elige una.

**Opción A: deja que lo haga VS Code (la más fácil).** Instala Visual Studio Code y la extensión oficial de Flutter. Abre la paleta de comandos (`Ctrl + Shift + P`), ejecuta **Flutter: New Project** y, cuando VS Code avise de que falta el SDK, elige **Download SDK** y selecciona una carpeta como `C:\Users\<tu-usuario>\develop`. VS Code clona el SDK estable y te ofrece añadirlo al PATH.

**Opción B: descarga el zip a mano.** Ve al archivo de versiones del SDK de Flutter en docs.flutter.dev, abre la pestaña de Windows en el canal stable y descarga el último zip estable. Esa es la descarga oficial de Flutter para Windows y la fuente más segura. Evita los mirrors de terceros.

También puedes clonarlo con Git si lo prefieres:

```powershell
git clone -b stable https://github.com/flutter/flutter.git C:\Users\<tu-usuario>\develop\flutter
```

## Paso 2: extraer Flutter en la carpeta adecuada

Extrae el zip de forma que te quede `C:\Users\<tu-usuario>\develop\flutter\bin\flutter.bat`. Dónde pones la carpeta importa más de lo que parece.

Usa una ruta que:

- no tenga **espacios** ni caracteres especiales,
- **no** esté dentro de `C:\Program Files\` (hace falta ser administrador para escribir ahí, y Flutter se actualiza solo),
- **no** esté dentro de una carpeta sincronizada con OneDrive (la sincronización bloquea archivos durante las actualizaciones y las builds).

`C:\Users\<tu-usuario>\develop\flutter` o `C:\src\flutter` funcionan bien.

## Paso 3: añadir Flutter al PATH

Este es el paso que soluciona el error más común, **`'flutter' is not recognized as an internal or external command`** (en Windows en español, "no se reconoce como un comando interno o externo").

1. Pulsa la tecla de Windows y busca **Editar las variables de entorno de esta cuenta** (en inglés, *Edit environment variables for your account*).
2. En **Variables de usuario**, selecciona **Path** y haz clic en **Editar**.
3. Haz clic en **Nuevo** y añade la ruta completa de la carpeta `bin`, por ejemplo `C:\Users\<tu-usuario>\develop\flutter\bin`.
4. Haz clic en **Aceptar** en todas las ventanas.
5. **Cierra todas las terminales y VS Code** y abre una nueva. Las ventanas antiguas mantienen el PATH antiguo.

Compruébalo:

```powershell
flutter --version
where.exe flutter
```

`where.exe flutter` debería mostrar la ruta que acabas de añadir. Si muestra dos rutas, quita la antigua del PATH para no ejecutar por error un Flutter desactualizado.

## Paso 4: ejecutar flutter doctor

`flutter doctor` revisa toda tu configuración y te dice exactamente qué falta:

```powershell
flutter doctor
```

Usa `flutter doctor -v` para ver todos los detalles. Una marca verde significa que esa parte está lista, una exclamación amarilla es un aviso y una cruz roja hay que arreglarla si necesitas esa plataforma. **No hace falta que todas las líneas estén en verde.** Si solo compilas apps para Android, puedes ignorar la línea de Visual Studio.

## Paso 5: configurar Android Studio y el Android SDK

Para compilar y ejecutar apps de Android:

1. Instala **Android Studio** desde developer.android.com y ábrelo una vez para que descargue el SDK por defecto.
2. Ve a **More Actions > SDK Manager** (o **Settings > Languages & Frameworks > Android SDK**).
3. En **SDK Platforms**, instala la última versión estable de Android.
4. En **SDK Tools**, marca **Android SDK Command-line Tools (latest)**, **Android SDK Build-Tools**, **Android SDK Platform-Tools** y **Android Emulator**. Haz clic en **Apply**.
5. Acepta las licencias de Android:

   ```powershell
   flutter doctor --android-licenses
   ```

   Pulsa `y` en cada licencia. Después vuelve a ejecutar `flutter doctor`.

6. Crea un emulador en **Device Manager**, o conecta un móvil con la **depuración por USB** activada en las opciones de desarrollador.

## Cómo solucionar los errores más comunes de flutter doctor

| Mensaje de error | Solución |
|---|---|
| `'flutter' is not recognized as an internal or external command` | La carpeta `flutter\bin` no está en el PATH o la terminal es antigua. Repite el paso 3 y abre una terminal nueva. |
| `Unable to find git in your PATH` | Instala Git para Windows y abre una terminal nueva. |
| `cmdline-tools component is missing` | En Android Studio, SDK Manager > SDK Tools, instala **Android SDK Command-line Tools (latest)**. |
| `Android license status unknown` | Ejecuta `flutter doctor --android-licenses` y acéptalas todas. Si falla, instala primero las herramientas de línea de comandos. |
| `Unable to locate Android SDK` | Ejecuta `flutter config --android-sdk "C:\Users\<tu-usuario>\AppData\Local\Android\Sdk"` con la ruta real de tu SDK. |
| `Could not determine Java version` o errores de Java en Gradle | Indica a Flutter el JDK que incluye Android Studio: `flutter config --jdk-dir "C:\Program Files\Android\Android Studio\jbr"`. |
| `Building with plugins requires symlink support` | Activa el **modo de desarrollador**: ejecuta `start ms-settings:developers` y actívalo. |
| `Visual Studio not installed` | Solo hace falta para apps de escritorio de Windows. Instala Visual Studio (no VS Code) con la carga de trabajo **Desktop development with C++**, o ignóralo. |
| `Cannot find Chrome executable` | Solo hace falta para Flutter web. Instala Chrome o define `CHROME_EXECUTABLE` con la ruta de otro navegador Chromium. |
| `No devices available` | Inicia un emulador desde el Device Manager de Android Studio, o activa la depuración por USB y acepta el aviso en tu móvil. Compruébalo con `flutter devices`. |

Si no vas a compilar para una plataforma, puedes desactivarla para que doctor deje de avisar, por ejemplo con `flutter config --no-enable-windows-desktop`.

## Paso 6: crear y ejecutar tu primera app

```powershell
flutter create my_app
cd my_app
flutter run
```

Flutter elige un dispositivo conectado o te pide que elijas uno. Con la app en marcha, pulsa `r` para el hot reload y `R` para el hot restart.

## Generar un APK o un App Bundle en Windows

Cuando quieras compartir la app:

```powershell
flutter build apk --release
```

El APK se crea en `build\app\outputs\flutter-apk\app-release.apk`. Úsalo para probar en dispositivos o compartirlo directamente.

Para Google Play, genera un Android App Bundle, porque Play exige el formato AAB para las apps nuevas:

```powershell
flutter build appbundle --release
```

Antes de subirlo a Play, crea una clave de firma de release y añádela a `android\key.properties` como explica la guía de despliegue de Android de Flutter.

**Sobre iOS:** puedes escribir y probar el código de Flutter en Windows, pero compilar y firmar una app de iOS requiere macOS y Xcode. Si no tienes un Mac, usa un servicio de CI en la nube con máquinas macOS para generar la versión de iOS.

## Mantener Flutter actualizado

```powershell
flutter upgrade
flutter --version
```

Quédate en el canal **stable** para proyectos reales (`flutter channel stable`). Flutter publica una nueva versión estable aproximadamente cada tres meses, y `flutter upgrade` la instala en el mismo sitio.

## Preguntas frecuentes

### ¿Cómo instalo Flutter en Windows 11?

Los pasos son los mismos que en Windows 10. Instala Git para Windows, descarga el zip estable del SDK de Flutter para Windows, extráelo en una ruta sin espacios como `C:\Users\<tu-usuario>\develop\flutter`, añade su carpeta `bin` al PATH de tu usuario, abre una terminal nueva y ejecuta `flutter doctor`.

### ¿Dónde debo poner la ruta del SDK de Flutter en Windows?

Usa una carpeta sencilla que sea tuya, como `C:\Users\<tu-usuario>\develop\flutter` o `C:\src\flutter`. Evita `C:\Program Files\` porque requiere permisos de administrador, evita rutas con espacios o caracteres especiales y evita las carpetas de OneDrive, porque la sincronización interfiere con las actualizaciones y las builds.

### ¿Necesito Android Studio para Flutter?

Necesitas el Android SDK para compilar apps de Android, y Android Studio es la forma más fácil de instalarlo y gestionarlo. Puedes escribir el código en VS Code y usar Android Studio solo para el SDK Manager y los emuladores. Si solo trabajas para web o escritorio de Windows, Android Studio no es necesario.

### ¿Necesito Visual Studio para Flutter en Windows?

Solo si compilas apps de escritorio de Windows. En ese caso necesitas Visual Studio (no VS Code) con la carga de trabajo "Desktop development with C++". Para apps de Android, iOS o web puedes ignorar el aviso de Visual Studio en `flutter doctor`.

### ¿Por qué flutter doctor dice que falta el componente cmdline-tools?

Android Studio no instala las herramientas de línea de comandos por defecto. Abre el SDK Manager, ve a la pestaña SDK Tools, marca "Android SDK Command-line Tools (latest)", aplica y vuelve a ejecutar `flutter doctor --android-licenses` y `flutter doctor`.

---

¿Todavía dudas entre Flutter y React Native? Lee mi comparativa: [Flutter vs React Native en 2026](https://arbabnaseer.com/es/articulos/flutter-vs-react-native-2026/). Si necesitas que desarrolle y publique una app en Flutter, [escríbeme](/es/contacto/).
