# How to Fix Flutter Install Windows Errors: Common SDK Setup Failures and Solutions > Encounter Flutter install Windows errors during SDK setup? Discover common causes like missing Git or Visual Studio with C++ and find quick solutions to get your Flutter development environment running. - Repository: [Flutter/flutter](https://github.com/flutter/flutter) - Tags: how-to-guide - Published: 2026-02-16 --- **Flutter install Windows errors typically stem from missing prerequisites such as command-line Git, Visual Studio 2019/2022 with C++ workloads, or the Windows 10 SDK, which the toolchain validates through `bin/flutter.bat` and `packages/flutter_tools/lib/src/windows/windows_workflow.dart` before completing SDK initialization.** When following the official flutter install Windows documentation, the SDK setup often fails during the initial validation phase. The Flutter toolchain enforces strict environment checks that go beyond simple ZIP extraction, requiring specific system dependencies to be present before `flutter doctor` can complete successfully. ## Common Causes of Flutter Install Windows Failures ### Missing Command-Line Git The Flutter installation bundles explicitly require a command-line version of Git for Windows operations. According to [`docs/infra/Flutter-Installation-Bundles.md`](https://github.com/flutter/flutter/blob/main/docs/infra/Flutter-Installation-Bundles.md), the tool expects `git` to be available in PATH. When missing, `flutter doctor` reports Git as not installed, causing the SDK setup to abort immediately. ### Incomplete Visual Studio Installation The Windows workflow validator in `packages/flutter_tools/lib/src/windows/windows_workflow.dart` checks for Visual Studio 2019 or 2022 with specific workloads. As documented in [`docs/engine/contributing/Compiling-the-engine.md`](https://github.com/flutter/flutter/blob/main/docs/engine/contributing/Compiling-the-engine.md), you must install the "Desktop development with C++" workload, ensuring **Microsoft.VisualStudio.Component.VC.Tools.x86.x64** and **Microsoft.VisualStudio.Component.Windows10SDK.19041** are present. Missing components trigger "Visual Studio not found" or "C++ build tools missing" errors. ### Missing Windows 10 SDK and Debugging Tools Even with Visual Studio installed, the setup fails if the Windows 10 SDK is absent or lacks Debugging Tools. The engine development environment documentation in [`docs/engine/contributing/Setting-up-the-Engine-development-environment.md`](https://github.com/flutter/flutter/blob/main/docs/engine/contributing/Setting-up-the-Engine-development-environment.md) specifies this requirement for non-Googlers. The validator checks registry keys such as `HKLM\SOFTWARE\Microsoft\Windows Kits\Installed Roots` to confirm installation. ### Path Length and Special Characters The Flutter engine and build tools default to Windows' traditional `MAX_PATH` limit of 260 characters. If the SDK resides in a deeply nested directory like `C:\Users\VeryLongUsername\Documents\Development\Flutter\flutter`, path operations fail with "Path too long" errors during `flutter create` or asset compilation. ### Windows Defender and Antivirus Interference According to [`docs/postmortems/Postmortem-Windows-Defender-alert-on-2023-03-26.md`](https://github.com/flutter/flutter/blob/main/docs/postmortems/Postmortem-Windows-Defender-alert-on-2023-03-26.md), Windows Defender may quarantine Flutter engine pre-built binaries or `.dll` files. This causes "Access denied" or "File not found" errors when launching Windows applications during setup verification. ### PowerShell Execution Policy Restrictions The `bin/flutter.bat` script invokes PowerShell for certain operations. If the execution policy is set to `Restricted`, the SDK initialization fails with "Execution of scripts is disabled on this system". ### Missing Environment Variables For Android development (often part of the Windows setup workflow), the toolchain checks `JAVA_HOME` and `ANDROID_SDK_ROOT`. Missing these variables causes `flutter doctor` to report the Android toolchain as not installed, even when the SDK files exist on disk. ### Corrupted Git Repository If the Flutter installation bundle is in an inconsistent state due to interrupted clones or merge conflicts, random "cannot find file" errors occur. The repository documentation in [`docs/wiki_archive/Workarounds-for-common-issues.md`](https://github.com/flutter/flutter/blob/main/docs/wiki_archive/Workarounds-for-common-issues.md) provides recovery steps for this scenario. ## Diagnostic Commands for Flutter Install Windows Before applying fixes, run these verification commands to identify specific missing components: ```powershell # Verify Git installation git --version ``` ```powershell # Check Visual Studio installation with required workloads & "C:\Program Files (x86)\Microsoft Visual Studio\Installer\vswhere.exe" -latest -products * -requires Microsoft.VisualStudio.Component.VC.Tools.x86.x64 -requires Microsoft.VisualStudio.Component.Windows10SDK.19041 -property installationPath ``` ```powershell # Verify Windows 10 SDK installation reg query "HKLM\SOFTWARE\Microsoft\Windows Kits\Installed Roots" /v KitRoot10 ``` ```bash # Run Flutter doctor to see specific errors flutter doctor ``` These checks mirror the validation logic found in `packages/flutter_tools/lib/src/windows/windows_workflow.dart` and `bin/flutter.bat`. ## Solutions for Flutter Install Windows Errors ### Install Missing Prerequisites If Git is missing, download the command-line Git for Windows from the official site and ensure it is added to your system PATH. For Visual Studio, run the Visual Studio Installer, select "Modify," and install the "Desktop development with C++" workload, ensuring the Windows 10 SDK and Debugging Tools are included. ### Clean a Corrupted Flutter Repository If you suspect repository corruption, run: ```bash cd C:\src\flutter git clean -fdx git reset --hard origin/master flutter doctor ``` This follows the cleanup procedure documented in [`docs/wiki_archive/Workarounds-for-common-issues.md`](https://github.com/flutter/flutter/blob/main/docs/wiki_archive/Workarounds-for-common-issues.md). ### Configure Windows Defender Exclusions To prevent antivirus interference: ```powershell Add-MpPreference -ExclusionPath "C:\src\flutter" ``` This addresses the quarantine issues described in [`docs/postmortems/Postmortem-Windows-Defender-alert-on-2023-03-26.md`](https://github.com/flutter/flutter/blob/main/docs/postmortems/Postmortem-Windows-Defender-alert-on-2023-03-26.md). ### Set PowerShell Execution Policy Allow script execution for Flutter tools: ```powershell Set-ExecutionPolicy -Scope CurrentUser RemoteSigned -Force ``` ### Enable Long Path Support If encountering path length errors, move the Flutter SDK to a shorter path such as `C:\src\flutter`. Alternatively, enable Windows 10 long path support via Group Policy or registry modification, though relocating the SDK is the most reliable immediate fix. ## Key Repository Files for Windows Setup Understanding these source files helps diagnose why `flutter doctor` fails: - **`bin/flutter.bat`**: The Windows entry point that launches the Dart snapshot and runs initial validation. It aborts early if critical prerequisites are missing. - **`packages/flutter_tools/lib/src/windows/windows_workflow.dart`**: Contains the Windows-specific validation logic that checks for Git, Visual Studio installations, and Windows SDK presence. - **[`docs/infra/Flutter-Installation-Bundles.md`](https://github.com/flutter/flutter/blob/main/docs/infra/Flutter-Installation-Bundles.md)**: Documents the Windows-only installation steps including the command-line Git requirement and bundle creation procedures. - **[`docs/engine/contributing/Setting-up-the-Engine-development-environment.md`](https://github.com/flutter/flutter/blob/main/docs/engine/contributing/Setting-up-the-Engine-development-environment.md)**: Lists the Windows 10 SDK and Debugging Tools requirements for engine development. - **[`docs/engine/contributing/Compiling-the-engine.md`](https://github.com/flutter/flutter/blob/main/docs/engine/contributing/Compiling-the-engine.md)**: Details the Visual Studio 2019/2022 requirements and necessary C++ workloads for engine compilation. - **[`docs/wiki_archive/Workarounds-for-common-issues.md`](https://github.com/flutter/flutter/blob/main/docs/wiki_archive/Workarounds-for-common-issues.md)**: Provides recovery steps for corrupted Git repositories and other installation issues. - **[`docs/postmortems/Postmortem-Windows-Defender-alert-on-2023-03-26.md`](https://github.com/flutter/flutter/blob/main/docs/postmortems/Postmortem-Windows-Defender-alert-on-2023-03-26.md)**: Documents Windows Defender quarantine issues and mitigation strategies. ## Summary - Flutter install Windows errors typically occur due to missing prerequisites: command-line Git, Visual Studio 2019/2022 with C++ workloads, and the Windows 10 SDK with Debugging Tools. - The toolchain enforces these requirements through `bin/flutter.bat` and `packages/flutter_tools/lib/src/windows/windows_workflow.dart` before completing SDK initialization. - Environmental factors including Windows Defender quarantine, restrictive PowerShell execution policies, path length limitations, and missing environment variables (`JAVA_HOME`, `ANDROID_SDK_ROOT`) can block setup. - Solutions include installing missing components, cleaning corrupted repositories with `git clean -fdx`, adding Windows Defender exclusions, and configuring PowerShell execution policies. ## Frequently Asked Questions ### Why does `flutter doctor` report that Visual Studio is not installed when I have it? This occurs when the required C++ workload is missing. According to `packages/flutter_tools/lib/src/windows/windows_workflow.dart`, Flutter specifically validates the presence of **Microsoft.VisualStudio.Component.VC.Tools.x86.x64** and **Microsoft.VisualStudio.Component.Windows10SDK.19041**. Run the Visual Studio Installer, select "Modify," and ensure the "Desktop development with C++" workload is fully installed. ### Can I install Flutter on Windows without Git? No. The official documentation in [`docs/infra/Flutter-Installation-Bundles.md`](https://github.com/flutter/flutter/blob/main/docs/infra/Flutter-Installation-Bundles.md) explicitly requires a command-line version of Git for Windows. The `bin/flutter.bat` script relies on Git commands to manage the SDK and run `flutter doctor`. Download Git for Windows from the official website and ensure it is added to your system PATH before running Flutter commands. ### How do I fix "Execution of scripts is disabled on this system" when running Flutter? This PowerShell error indicates the execution policy is too restrictive. Flutter's `bin/flutter.bat` invokes PowerShell scripts during initialization. To resolve this, run `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned -Force` in an elevated PowerShell window. This allows local scripts to execute while maintaining security for remote scripts. ### Why does Flutter setup fail with "Path too long" errors on Windows? The Flutter engine and Windows build tools default to the traditional `MAX_PATH` limit of 260 characters. If the SDK is installed in a deeply nested directory such as `C:\Users\VeryLongUsername\Documents\Development\Flutter\flutter`, file operations fail. Move the Flutter SDK to a shorter path like `C:\src\flutter`, or enable Windows 10 long path support through the Group Policy Editor or registry settings.