---
title: "Installer Flutter sur Windows et corriger les erreurs de flutter doctor"
description: "Installer Flutter sur Windows pas à pas : télécharger le SDK, configurer le PATH et Android Studio, et corriger les erreurs courantes de flutter doctor."
url: "https://arbabnaseer.com/fr/articles/installer-flutter-windows-flutter-doctor/"
lang: "fr"
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"
---

# Installer Flutter sur Windows et corriger les erreurs de flutter doctor

> Installer Flutter sur Windows pas à pas : télécharger le SDK, configurer le PATH et Android Studio, et corriger les erreurs courantes de flutter doctor.

Arbab Naseer · 2026-10-11 · https://arbabnaseer.com/fr/articles/installer-flutter-windows-flutter-doctor/

**Réponse courte :** installez Git pour Windows, téléchargez le zip du SDK Flutter pour Windows (ou laissez VS Code le télécharger), extrayez-le dans un chemin simple comme `C:\Users\<vous>\develop\flutter`, ajoutez le dossier `flutter\bin` au PATH de votre utilisateur, ouvrez un nouveau terminal et lancez `flutter doctor`. Installez ensuite Android Studio et les outils en ligne de commande du SDK Android, puis acceptez les licences avec `flutter doctor --android-licenses`.

Ce guide reprend l'installation que j'utilise pour mon propre travail sur Flutter, dont [PocketPOS](https://arbabnaseer.com/fr/projets/pocketpos-application-caisse-facturation-khata/), et couvre les erreurs que je rencontre le plus souvent quand j'aide d'autres développeurs à démarrer. Il a été écrit pour Flutter 3.47, la version stable actuelle en octobre 2026, mais les étapes changent très peu d'une version à l'autre.

## Ce qu'il vous faut avant d'installer Flutter

Il vous faut un PC sous Windows 10 ou Windows 11 64 bits, environ 10 Go d'espace libre pour Flutter et les outils Android, et **Git pour Windows**. Flutter utilise Git pour gérer ses propres versions, donc `flutter doctor` échoue sans lui. Android Studio n'est nécessaire que pour compiler pour Android, et Visual Studio seulement pour les applications desktop Windows.

Installez Git depuis git-scm.com avec les options par défaut, puis vérifiez-le dans une nouvelle fenêtre PowerShell :

```powershell
git --version
```

## Étape 1 : télécharger le SDK Flutter pour Windows

Il y a deux bonnes façons d'obtenir le SDK. Choisissez-en une.

**Option A : laisser VS Code s'en charger (le plus simple).** Installez Visual Studio Code et l'extension Flutter officielle. Ouvrez la palette de commandes (`Ctrl + Shift + P`), lancez **Flutter: New Project** et, quand VS Code indique que le SDK est absent, choisissez **Download SDK** et sélectionnez un dossier comme `C:\Users\<vous>\develop`. VS Code clone le SDK stable et propose de l'ajouter à votre PATH.

**Option B : télécharger le zip à la main.** Allez dans l'archive du SDK Flutter sur docs.flutter.dev, ouvrez l'onglet Windows du canal stable et téléchargez le dernier zip stable. C'est le téléchargement officiel de Flutter pour Windows et la source la plus sûre. Évitez les miroirs tiers.

Vous pouvez aussi le cloner avec Git si vous préférez :

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

## Étape 2 : extraire Flutter dans le bon dossier

Extrayez le zip de façon à obtenir `C:\Users\<vous>\develop\flutter\bin\flutter.bat`. L'emplacement du dossier compte plus qu'on ne le pense.

Choisissez un chemin qui :

- ne contient **aucun espace** ni caractère spécial,
- n'est **pas** dans `C:\Program Files\` (il faut les droits administrateur pour y écrire, et Flutter se met à jour tout seul),
- n'est **pas** dans un dossier synchronisé par OneDrive (la synchronisation verrouille des fichiers pendant les mises à jour et les builds).

`C:\Users\<vous>\develop\flutter` ou `C:\src\flutter` conviennent très bien.

## Étape 3 : ajouter Flutter au PATH

C'est l'étape qui corrige l'erreur la plus fréquente, **`'flutter' is not recognized as an internal or external command`** (sur un Windows en français, "n'est pas reconnu en tant que commande interne ou externe").

1. Appuyez sur la touche Windows et cherchez **Modifier les variables d'environnement pour votre compte** (en anglais, *Edit environment variables for your account*).
2. Sous **Variables utilisateur**, sélectionnez **Path** et cliquez sur **Modifier**.
3. Cliquez sur **Nouveau** et ajoutez le chemin complet du dossier `bin`, par exemple `C:\Users\<vous>\develop\flutter\bin`.
4. Cliquez sur **OK** dans chaque fenêtre.
5. **Fermez tous les terminaux et VS Code**, puis ouvrez-en un nouveau. Les anciennes fenêtres gardent l'ancien PATH.

Vérifiez :

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

`where.exe flutter` doit afficher le chemin que vous venez d'ajouter. S'il en affiche deux, retirez l'ancien du PATH pour ne pas lancer par erreur une version obsolète de Flutter.

## Étape 4 : lancer flutter doctor

`flutter doctor` vérifie toute votre installation et vous dit exactement ce qui manque :

```powershell
flutter doctor
```

Utilisez `flutter doctor -v` pour tous les détails. Une coche verte signifie que cette partie est prête, un point d'exclamation jaune est un avertissement et une croix rouge doit être corrigée si vous avez besoin de cette plateforme. **Inutile que toutes les lignes soient vertes.** Si vous ne compilez que pour Android, vous pouvez ignorer la ligne Visual Studio.

## Étape 5 : configurer Android Studio et le SDK Android

Pour compiler et lancer des applications Android :

1. Installez **Android Studio** depuis developer.android.com et ouvrez-le une fois pour qu'il télécharge le SDK par défaut.
2. Allez dans **More Actions > SDK Manager** (ou **Settings > Languages & Frameworks > Android SDK**).
3. Dans **SDK Platforms**, installez la dernière version stable d'Android.
4. Dans **SDK Tools**, cochez **Android SDK Command-line Tools (latest)**, **Android SDK Build-Tools**, **Android SDK Platform-Tools** et **Android Emulator**. Cliquez sur **Apply**.
5. Acceptez les licences Android :

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

   Appuyez sur `y` pour chaque licence. Relancez ensuite `flutter doctor`.

6. Créez un émulateur dans **Device Manager**, ou branchez un téléphone avec le **débogage USB** activé dans les options pour les développeurs.

## Corriger les erreurs flutter doctor les plus courantes

| Message d'erreur | Correction |
|---|---|
| `'flutter' is not recognized as an internal or external command` | Le dossier `flutter\bin` n'est pas dans le PATH, ou le terminal est ancien. Refaites l'étape 3 et ouvrez un nouveau terminal. |
| `Unable to find git in your PATH` | Installez Git pour Windows, puis ouvrez un nouveau terminal. |
| `cmdline-tools component is missing` | Dans Android Studio, SDK Manager > SDK Tools, installez **Android SDK Command-line Tools (latest)**. |
| `Android license status unknown` | Lancez `flutter doctor --android-licenses` et acceptez tout. En cas d'échec, installez d'abord les outils en ligne de commande. |
| `Unable to locate Android SDK` | Lancez `flutter config --android-sdk "C:\Users\<vous>\AppData\Local\Android\Sdk"` avec le vrai chemin de votre SDK. |
| `Could not determine Java version` ou erreurs Java dans Gradle | Indiquez à Flutter le JDK fourni avec Android Studio : `flutter config --jdk-dir "C:\Program Files\Android\Android Studio\jbr"`. |
| `Building with plugins requires symlink support` | Activez le **mode développeur** : lancez `start ms-settings:developers` et activez-le. |
| `Visual Studio not installed` | Nécessaire uniquement pour les applications desktop Windows. Installez Visual Studio (pas VS Code) avec la charge de travail **Desktop development with C++**, ou ignorez-le. |
| `Cannot find Chrome executable` | Nécessaire uniquement pour Flutter web. Installez Chrome, ou définissez `CHROME_EXECUTABLE` avec le chemin d'un autre navigateur Chromium. |
| `No devices available` | Lancez un émulateur depuis le Device Manager d'Android Studio, ou activez le débogage USB et acceptez la demande sur votre téléphone. Vérifiez avec `flutter devices`. |

Si vous ne comptez pas compiler pour une plateforme, vous pouvez la désactiver pour que doctor cesse d'avertir, par exemple avec `flutter config --no-enable-windows-desktop`.

## Étape 6 : créer et lancer votre première application

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

Flutter choisit un appareil connecté ou vous demande d'en choisir un. Pendant que l'application tourne, appuyez sur `r` pour le hot reload et sur `R` pour le hot restart.

## Générer un APK ou un App Bundle sous Windows

Quand vous êtes prêt à partager l'application :

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

L'APK est créé dans `build\app\outputs\flutter-apk\app-release.apk`. Utilisez-le pour tester sur des appareils ou le partager directement.

Pour Google Play, générez plutôt un Android App Bundle, car Play exige le format AAB pour les nouvelles applications :

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

Avant d'envoyer sur Play, créez une clé de signature de release et ajoutez-la à `android\key.properties` comme le décrit le guide de déploiement Android de Flutter.

**À propos d'iOS :** vous pouvez écrire et tester le code Flutter sous Windows, mais compiler et signer une application iOS demande macOS et Xcode. Sans Mac, utilisez un service de CI dans le cloud avec des machines macOS pour générer la version iOS.

## Garder Flutter à jour

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

Restez sur le canal **stable** pour les vrais projets (`flutter channel stable`). Flutter publie une nouvelle version stable environ tous les trois mois, et `flutter upgrade` l'installe sur place.

## Questions fréquentes

### Comment installer Flutter sur Windows 11 ?

Les étapes sont les mêmes que sous Windows 10. Installez Git pour Windows, téléchargez le zip stable du SDK Flutter pour Windows, extrayez-le dans un chemin sans espaces comme `C:\Users\<vous>\develop\flutter`, ajoutez son dossier `bin` au PATH de votre utilisateur, ouvrez un nouveau terminal et lancez `flutter doctor`.

### Où placer le SDK Flutter sous Windows ?

Utilisez un dossier simple qui vous appartient, comme `C:\Users\<vous>\develop\flutter` ou `C:\src\flutter`. Évitez `C:\Program Files\` qui demande les droits administrateur, évitez les chemins avec des espaces ou des caractères spéciaux, et évitez les dossiers OneDrive, car la synchronisation perturbe les mises à jour et les builds.

### Faut-il Android Studio pour Flutter ?

Il faut le SDK Android pour compiler des applications Android, et Android Studio est le moyen le plus simple de l'installer et de le gérer. Vous pouvez écrire le code dans VS Code et n'utiliser Android Studio que pour le SDK Manager et les émulateurs. Pour le web ou le desktop Windows uniquement, Android Studio n'est pas nécessaire.

### Faut-il Visual Studio pour Flutter sous Windows ?

Seulement si vous compilez des applications desktop Windows. Il vous faut alors Visual Studio (pas VS Code) avec la charge de travail "Desktop development with C++". Pour des applications Android, iOS ou web, vous pouvez ignorer l'avertissement Visual Studio dans `flutter doctor`.

### Pourquoi flutter doctor indique que le composant cmdline-tools est manquant ?

Android Studio n'installe pas les outils en ligne de commande par défaut. Ouvrez le SDK Manager, allez dans l'onglet SDK Tools, cochez "Android SDK Command-line Tools (latest)", appliquez, puis relancez `flutter doctor --android-licenses` et `flutter doctor`.

---

Vous hésitez encore entre Flutter et React Native ? Lisez mon comparatif : [Flutter vs React Native en 2026](https://arbabnaseer.com/fr/articles/flutter-vs-react-native-2026/). Si vous avez besoin d'une application Flutter développée et publiée, [contactez-moi](/fr/contact/).
