🧭 一、搭建目标

• 在 Windows 上配置 Flutter SDK ✅

• 安装 Android Studio 并完成优化配置 ✅

• 安装 Android SDK 与模拟器 ✅

• 成功运行第一个 Flutter App ✅

---

🧰 二、环境搭建全流程

1️⃣ 安装 Flutter SDK

下载： https://flutter.dev/docs/get-started/install/windows

推荐路径：

G:\dev_environment\flutter3.35.7

配置环境变量：

1. 打开系统环境变量 → 编辑 Path → 新建：

   G:\dev_environment\flutter3.35.7\bin
   

2. 重新打开命令行，执行：

   flutter doctor
   

验证成功输出：

[√] Flutter (Channel stable, 3.35.7, ...)

---

2️⃣ 安装 Android Studio

下载： https://developer.android.com/studio

安装时勾选：

• ✅ Android SDK

• ✅ Android SDK Platform

• ✅ Android Virtual Device (AVD)

推荐路径：

G:\dev_environment\Android\AndroidStudio

SDK 默认路径：

C:\Users\<用户名>\AppData\Local\Android\Sdk

若自定义为 G:\dev_environment\AndroidSdk：

flutter config --android-sdk "G:\\dev_environment\\AndroidSdk"

---

⚙️ 三、Android Studio 必备配置优化

🧩 1. 设置统一编码格式

打开 Android Studio：

• 点击 File → Settings → Editor → File Encodings

• 修改以下配置：

  • Global Encoding：UTF-8

  • Project Encoding：UTF-8

  • Properties Files Encoding：UTF-8

• ✅ 勾选：Transparent native-to-ascii conversion

👉 作用： 防止中文注释、JSON 文件乱码。

---

🧩 2. 常用插件推荐

进入：File → Settings → Plugins → Marketplace

搜索并安装：

• Flutter（核心插件）

• Dart（自动安装）

• Material Theme UI（美化界面）

• Rainbow Brackets（彩色括号）

• CodeGlance（代码小地图）

👉 作用： 提高可读性与开发效率。

---

🧩 3. 快捷键优化建议

推荐将部分快捷键调整为类似 VSCode 风格：

路径：File → Settings → Keymap

常用快捷键：

操作	快捷键
运行 App	Shift + F10
停止运行	Ctrl + F2
格式化代码	Ctrl + Alt + L
搜索类/文件	Ctrl + N / Ctrl + Shift + N
打开终端	Alt + F12
查看 Flutter Inspector	Shift + Ctrl + I

---

🧩 4. 调整内存和性能设置

路径：Help → Edit Custom VM Options

推荐参数：

-Xms1024m
-Xmx4096m
-XX:ReservedCodeCacheSize=1024m
-XX:+UseG1GC

保存后重启 IDE。

👉 作用： 加快索引速度、减少卡顿。

---

3️⃣ 创建 Android 模拟器（AVD）

Android Studio → More Actions → Virtual Device Manager → Create Device

1. 选择 Pixel 6

2. 选择系统镜像（Android 13 / API 33）

3. 点击 “Finish” 创建并启动

验证：

flutter devices

出现 emulator-5554 表示识别成功。

---

⚠️ 四、常见错误与解决方案大全

错误提示	原因分析	解决方案
❌ Unable to locate Android SDK	Flutter 未找到 SDK 路径	使用命令 flutter config --android-sdk <路径> 指定正确目录
❌ cmdline-tools component is missing	未安装命令行工具	打开 Android Studio → SDK Manager → SDK Tools 勾选 Android SDK Command-line Tools (latest)，或手动下载解压至 ...\\cmdline-tools\\latest\\
⚠️ Android license status unknown	未接受 SDK 许可协议	运行 flutter doctor --android-licenses 并一路输入 y
⚠️ Network error: 信号灯超时	国内网络访问 Maven 仓库失败	配置 Flutter 镜像源：setx PUB_HOSTED_URL https://pub.flutter-io.cnsetx FLUTTER_STORAGE_BASE_URL https://storage.flutter-io.cn
⚠️ Visual Studio not installed	未安装 Windows 桌面依赖	仅 Android 开发可忽略

---

🧪 五、运行第一个 Flutter App

flutter create hello_flutter
cd hello_flutter
flutter run

若出现蓝色计数器界面，代表环境配置成功 🎉。

---

📋 六、最终验证 (flutter doctor 结果)

[√] Flutter (Channel stable, 3.35.7)
[√] Android toolchain - develop for Android devices
[√] Android Studio (version 2025.1.4)
[√] Connected device (3 available)

---

🪄 七、Flutter Windows 环境搭建流程图（Mermaid）

flowchart TD
A[下载 Flutter SDK] --> B[解压至 G:\\dev_environment\\flutter3.35.7]
B --> C[配置系统环境变量 PATH]
C --> D[运行 flutter doctor 检查]
D --> E[安装 Android Studio]
E --> F[勾选安装 SDK + 平台 + 模拟器]
F --> G[配置 SDK 路径 flutter config --android-sdk]
G --> H[安装 cmdline-tools 组件]
H --> I[运行 flutter doctor --android-licenses 接受许可]
I --> J[创建 Android 模拟器 AVD]
J --> K[优化 Android Studio 配置 (UTF-8, 插件, 快捷键, 内存)]
K --> L[运行 flutter devices 验证设备]
L --> M[创建并运行 hello_flutter 项目]
M --> N[看到蓝色计数器 App = 成功 🎉]

---

🧩 八、总结与发布建议

✅ 你现在已经：

• 成功安装 Flutter SDK、Android Studio 与 Android 模拟器

• 优化了 Android Studio 编码、性能与插件配置

• 解决了常见的环境错误（cmdline-tools、license、网络问题）

• 能运行第一个 Flutter 应用