Windows 上 Flutter 开发环境配置指南一、系统要求 Windows 10 / 11（64 位），建议 2

一、系统要求

Windows 10 / 11（64 位），建议 22H2 或更新版本
8 GB 以上内存，30 GB 以上可用硬盘空间
管理员权限（用于安装软件）

二、安装必要的前置工具

1. 安装 Git for Windows

下载地址：git-scm.com
安装时使用默认选项即可。
验证：打开命令提示符，输入 git --version，应显示版本信息。

2. 安装 Visual Studio （用于 Windows 桌面应用编译）

注意：不要安装 VS Code，需要安装完整的 Visual Studio Community 版。

下载：Visual Studio Community
运行安装程序，在 “工作负荷” 选项卡中，务必勾选“使用 C++ 的桌面开发”（Desktop development with C++），包含所有默认组件。
如果之前只安装了核心编辑器（提示“无工作负载”），请回到安装程序点击“修改”并添加上面的工作负荷。
安装完成后重启电脑。

三、安装 Flutter SDK

1. 下载 SDK

访问 Flutter 官网，下载最新稳定版压缩包。

2. 解压到合适路径

建议解压到用户目录下，例如 C:\Users\你的用户名\flutter
（避免 C:\Program Files 等受系统保护的文件夹，否则可能因权限问题导致命令失败）

3. 配置环境变量（关键步骤）

右键“此电脑” → “属性” → “高级系统设置” → “环境变量”
系统变量 中的 Path 变量，点击“编辑” → “新建” → 添加 Flutter 的 bin 目录路径，例如：C:\Users\你的用户名\flutter\bin
建议将 Git 的路径（C:\Program Files\Git\cmd）上移到系统路径之上，避免冲突。

4. 配置国内镜像（加速依赖下载）

在 用户变量 中新建以下两个变量：

变量名	变量值
`PUB_HOSTED_URL`	`https://pub.flutter-io.cn`
`FLUTTER_STORAGE_BASE_URL`	`https://storage.flutter-io.cn`

四、安装 Android 开发环境

1. 安装 Android Studio

下载：Android Studio
安装时选择标准（Standard）设置，会自动安装 Android SDK 和必要的组件。

2. 安装 Android SDK Command-line Tools

启动 Android Studio → More Actions → SDK Manager
切换到 SDK Tools 选项卡
找到 Android SDK Command-line Tools (latest) 并勾选，点击 Apply 安装。

3. 设置 ANDROID_HOME 环境变量

在环境变量中，新建系统变量：
- 变量名：ANDROID_HOME
- 变量值：你的 Android SDK 路径（默认：C:\Users\你的用户名\AppData\Local\Android\Sdk）
并将以下路径添加到 Path 变量中：
- %ANDROID_HOME%\platform-tools
- %ANDROID_HOME%\cmdline-tools\latest\bin

4. 接受 Android 许可协议

打开命令提示符，执行：
```
flutter doctor --android-licenses
```
遇到提示时，连续输入 y 并回车，直到所有许可都被接受。

五、安装编辑器及插件

备选：Android Studio

同样支持 Flutter/Dart 插件，安装方式类似。

六、验证环境

重新打开一个新的命令提示符（确保环境变量生效）
执行：
```
flutter doctor -v
```

理想状态下，所有项都应显示 [√]（绿色勾号），例如：

[√] Flutter (Channel stable, ...)
[√] Windows Version
[√] Android toolchain
[√] Chrome - develop for the web
[√] Visual Studio - develop Windows apps
[√] Connected device
[√] Network resources

七、常见问题与解决方案

问题1：`'flutter' 不是内部或外部命令`

原因：环境变量未配置或未生效
解决：
- 检查 Path 中是否包含 Flutter 的 bin 目录
- 重新启动命令行窗口（必须）
- 尝试在 Flutter bin 目录下直接运行 .\flutter doctor，如果能运行说明环境变量问题

问题2：运行 `flutter doctor` 闪退（无输出）

原因：Git 安全策略或环境变量顺序问题
解决：
- 在 Git Bash 中运行：git config --global --add safe.directory '*'
- 调整 Path 变量，将 Git 路径移到系统路径之上
- 将 Flutter SDK 移到用户目录（如 C:\Users\用户名\flutter）

问题3：提示 `cmdline-tools component is missing`

解决：按第四步第2小节安装命令行工具，或手动下载并解压到 %ANDROID_HOME%\cmdline-tools\latest\

问题4：提示 `Android license status unknown`

解决：运行 flutter doctor --android-licenses 并全部接受

问题5：提示 `Visual Studio not installed` 或缺少 C++ 开发工具

解决：重新运行 Visual Studio Installer，修改已安装的 VS 2022，添加 “使用 C++ 的桌面开发” 工作负荷

问题6：`flutter doctor` 卡在某处不继续

解决：通常是因为网络慢，可尝试关闭命令行后重新运行，或者配置代理

八、创建一个测试项目

flutter create my_app
cd my_app
flutter run -d windows   # 运行 Windows 桌面应用

如果看到应用窗口成功弹出，说明环境配置完全正确。

按照本指南操作后，你的 Windows 电脑就具备了完整的 Flutter 跨平台开发能力（Android、Windows、Web）。如果在配置过程中遇到其他未列出的错误，请根据 flutter doctor -v 的详细提示信息进行修复，或者随时继续提问。祝你开发顺利！

Windows 上 Flutter 开发环境配置指南