Windows 上安装 Flutter：从零搭环境到能跑起来的完整教程

目标关键词：Windows Flutter 安装

如果你想在 Windows 电脑上开发 Flutter 应用，第一步不是急着写代码，而是把开发环境搭好。很多新手卡在的地方，其实不是 Flutter 本身，而是 SDK 路径、Android 环境、Java、权限、网络、终端配置 这些基础环节。
这篇文章就按“小白能看懂、一步一步能做”的方式，把 Windows 上安装 Flutter 的全过程讲清楚，尽量少走弯路。

一、先搞清楚：Flutter 安装到底要装什么

很多人以为“安装 Flutter”就是下载一个压缩包解压完事，其实远不止这样。
在 Windows 上跑 Flutter，通常要准备下面这些东西：

Flutter SDK
Git
Android Studio
Android SDK
JDK（Java 开发环境）
环境变量配置
模拟器或真机调试工具

如果你只是想写 Flutter Web，要求会少一些；
如果你要开发 Android App，上面这些基本都要配齐。

二、安装前的准备工作

1. 检查系统版本

Flutter 在 Windows 上建议使用：

Windows 10 64 位及以上
Windows 11 更稳
64 位 CPU
至少 8GB 内存，推荐 16GB
硬盘预留 10GB 以上空间，后续装 Android Studio 和 SDK 会占不少空间

2. 打开系统虚拟化支持

如果你后面要用 Android 模拟器，最好在 BIOS 里开启虚拟化：

Intel：VT-x
AMD：SVM

进入任务管理器 → 性能 → CPU，看右下角是否显示“虚拟化：已启用”。
如果没启用，后面模拟器可能会很慢，甚至无法启动。

三、安装 Flutter SDK

1. 下载 Flutter SDK

去 Flutter 官网下载 Windows 版本 SDK，选择 Flutter Windows x64 压缩包。
下载完成后，建议解压到一个没有中文和空格的路径，比如：

D:\dev\flutter

不建议放在这些路径：

桌面
下载
C:\Program Files
含中文路径，比如 D:\开发工具\flutter

原因很简单：有些工具对中文路径、空格路径兼容性不太稳定，容易出奇怪问题。

2. 解压 Flutter

把压缩包解压后，目录里会有类似这些文件：

bin
packages
examples
README.md

真正要用到的是 bin 目录里的可执行工具。

四、配置 Flutter 环境变量

1. 加入 PATH

右键“此电脑” → 属性 → 高级系统设置 → 环境变量。

在“系统变量”里找到 Path，点“编辑”，新增一条：

D:\dev\flutter\bin

保存后，关闭所有终端窗口，重新打开。

2. 验证是否成功

打开 PowerShell 或 CMD，输入：

flutter --version

如果能显示版本信息，说明 Flutter SDK 已经识别成功。

如果提示“不是内部或外部命令”，通常是：

路径没加对
终端没重开
解压路径写错了
目录层级多套了一层

比如你实际路径是：

D:\dev\flutter\flutter\bin

那就说明你加错了，应该改成真正的 bin 所在目录。

五、安装 Git

Flutter 依赖 Git 来管理一些组件，所以 Git 基本是必装的。

安装步骤

下载 Git for Windows
默认安装即可
安装完成后打开命令行输入：

git --version

如果能显示版本号，说明 Git 正常。

注意事项

如果你安装 Git 后，命令行里找不到它，可以重新安装一次，或者把 Git 的 cmd 目录加入环境变量。
一般默认安装不会有大问题。

六、安装 Android Studio

如果你要开发 Android 应用，Android Studio 基本是必需的，因为它自带：

Android SDK
SDK Platform
模拟器
设备管理工具

1. 下载并安装

下载安装 Android Studio，默认一路下一步即可。
安装时建议勾选：

Android Studio
Android SDK
Android Virtual Device

2. 第一次启动设置

打开 Android Studio 后，它会引导你安装一些组件。
新手建议直接用默认推荐设置，不要自己乱改路径。

七、配置 Android SDK

安装 Android Studio 后，还要确认 Android SDK 已正确安装。

1. 查看 SDK 路径

打开 Android Studio：

File → Settings
Appearance & Behavior
System Settings
Android SDK

这里会显示 SDK 的安装路径，常见路径类似：

C:\Users\你的用户名\AppData\Local\Android\Sdk

2. 安装必要组件

在 SDK Manager 里，建议至少安装这些：

Android SDK Platform
Android SDK Build-Tools
Android SDK Platform-Tools
Android Emulator
Android SDK Command-line Tools

如果你不确定选什么，优先勾选最新稳定版本的 Android 平台包。

八、安装 JDK

Flutter + Android 开发离不开 Java 环境。
现在多数情况下，Android Studio 自带的 JDK 就够用，但有些项目或环境会要求单独配置。

建议方案

优先使用 Android Studio 自带 JDK
如果后续报 Java 版本问题，再单独安装 JDK 17

查看是否可用

打开命令行执行：

java -version

如果能看到版本号，说明 Java 已经可用。

常见建议

目前比较稳的做法是：

JDK 17
避免使用太老的 JDK
不要同时装多个 JDK 后又不整理环境变量

九、配置 Android 环境变量

有些时候 Flutter 找不到 Android SDK，需要手动配置环境变量。

1. 添加 ANDROID_HOME

环境变量中新增：

ANDROID_HOME=C:\Users\你的用户名\AppData\Local\Android\Sdk

2. 把这些路径加入 Path

%ANDROID_HOME%\platform-tools
%ANDROID_HOME%\emulator
%ANDROID_HOME%\cmdline-tools\latest\bin

如果你的 cmdline-tools 目录不是 latest，就按实际目录名称填写。

3. 验证 ADB

打开命令行输入：

adb version

如果有版本号输出，说明 platform-tools 生效了。

十、运行 Flutter 检查命令

Flutter 安装完，不要急着开项目，先做健康检查。

在命令行输入：

flutter doctor

这条命令非常关键，它会检查：

Flutter SDK 是否正常
Git 是否可用
Android Studio 是否安装
Android SDK 是否齐全
是否接受 Android 授权协议
是否能连接设备

正常情况下，你会看到类似检查项：

[√] Flutter
[√] Android toolchain
[√] Android Studio
[√] Connected device

如果有红色叉号，就按提示逐项修复。

十一、解决 flutter doctor 常见报错

1. 提示未接受 Android licenses

执行：

flutter doctor --android-licenses

然后一路输入 y 接受协议。

2. 提示找不到 Android SDK

先确认 Android Studio 里 SDK 是否安装好了。
如果安装了，还找不到，可以手动设置：

flutter config --android-sdk C:\Users\你的用户名\AppData\Local\Android\Sdk

然后再运行：

flutter doctor

3. 提示 Java 版本不兼容

常见原因是：

JDK 版本太老
系统里装了多个 Java
环境变量指向了错误版本

解决方法：

优先用 JDK 17
检查 JAVA_HOME
检查 Path 里是不是有旧 Java 路径

4. 提示 Git 不可用

检查：

git --version

如果不行，就重装 Git，或者把 Git 加到环境变量。

5. 模拟器启动慢或打不开

常见原因：

BIOS 没开虚拟化
Windows Hyper-V 配置冲突
内存太小
模拟器镜像太重

解决建议：

开启 CPU 虚拟化
关闭不必要后台程序
优先用真机调试
模拟器机型选轻量一点的

十二、创建第一个 Flutter 项目

环境装好后，可以试着创建一个项目。

1. 用命令行创建

进入你想放项目的目录，执行：

flutter create my_app

进入项目目录：

cd my_app

启动项目：

flutter run

2. 选择设备

如果你连了手机，Flutter 会让你选择运行设备。
如果你开了 Android 模拟器，也可以直接跑到模拟器里。

十三、连接真机调试

对新手来说，真机调试往往比模拟器更省心。

安卓手机连接步骤

打开手机“开发者选项”
开启“USB 调试”
用数据线连接电脑
手机上弹出授权窗口，点允许
命令行输入：

flutter devices

如果手机显示出来了，就可以运行：

flutter run

注意事项

数据线尽量用原装或高质量线
有些线只能充电，不能传数据
首次连接手机要手动授权
手机驱动异常时，可能需要安装品牌 USB 驱动

十四、推荐的安装顺序

如果你想少踩坑，建议按这个顺序来：

安装 Git
解压 Flutter SDK
配置 Flutter 环境变量
安装 Android Studio
安装 Android SDK
配置 Android 环境变量
执行 flutter doctor
接受 licenses
连接真机或启动模拟器
创建第一个项目测试

这个顺序比较稳，不容易乱。

十五、新手最容易踩的坑

1. 路径里有中文

尽量避免。
Flutter、Android SDK、项目目录，都尽量放在纯英文路径下。

2. 解压层级过深

比如：

D:\tools\flutter_windows_3.xx.x-stable\flutter\bin

这种多套一层的情况很常见。
环境变量里要填的是真实的 bin 路径。

3. 没有重启终端

环境变量改完后，必须关闭旧命令行窗口，重新开一个。

4. 只装 Flutter，不装 Android Studio

如果你要做 Android 应用，这样不够。
Flutter 只是框架，Android 构建环境还得靠 SDK。

5. 模拟器太吃资源

老电脑上直接开模拟器，卡顿很正常。
这种情况下优先用真机。

十六、适合不同水平用户的安装建议

新手用户

推荐直接按官方思路安装：

Flutter SDK
Git
Android Studio
Android SDK
真机调试

不要自己手动乱改太多配置，先保证能跑起来。

进阶用户

可以进一步优化：

Flutter 放到独立开发盘
项目和缓存分离
使用命令行 + VS Code 开发
配合真机和模拟器双调试

专业用户

可以考虑：

多版本 Flutter 切换
FVM 管理 Flutter 版本
CI/CD 自动构建
自定义 Android 构建环境
结合 Docker、WSL 做辅助开发

十七、一个更稳的实战配置方案

如果你想要一套省心配置，可以直接参考这个组合：

系统：Windows 11 64 位
Flutter：解压到 D:\dev\flutter
Git：默认安装
Android Studio：默认安装
Android SDK：默认路径
JDK：优先使用 Android Studio 内置 JDK
调试方式：先用真机，再上模拟器

这套方案对大多数新手都比较友好，出错率低。

十八、安装完成后的检查清单

安装完之后，建议按下面顺序确认：

flutter --version 能输出版本
git --version 能输出版本
java -version 正常
adb version 正常
flutter doctor 基本全绿
真机能被 flutter devices 识别
flutter run 能正常启动项目

只要这几项都过了，基本就说明 Windows Flutter 环境搭好了。

结语式总结

Windows 上安装 Flutter，核心不是“下载完就结束”，而是把 Flutter SDK、Git、Android Studio、Android SDK、Java、环境变量 这几块一起配好。
新手最稳的做法，就是优先走“官方推荐路径”，路径尽量纯英文，安装后立刻用 flutter doctor 做完整检查，再用真机跑一个最小项目验证环境。这样比盲目折腾配置文件省事得多，也更不容易卡在莫名其妙的报错里。