Saltar al contenido
Descargar CV

Escritos

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.

Publicado el Actualizado el 7 min de lectura

  • Flutter
  • Windows
  • flutter doctor
  • Android Studio
  • Dart

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, 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:

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:

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:

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:

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:

    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

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:

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:

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

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. Si necesitas que desarrolle y publique una app en Flutter, escríbeme.

Más artículos

¿Tienes una app en mente?

Cuéntame qué estás construyendo. Respondo a cada consulta seria en un plazo de dos días laborables.