【Flutter】Flutter + Android Studio Windows 环境搭建全流程与配置优化

原创已于 2025-10-27 03:07:07 修改 · 652 阅读

7 ·

CC 4.0 BY-SA版权

文章标签：

#flutter #android studio #windows #环境搭建

于 2025-10-26 12:54:39 首次发布

AI的出现，是否能替代IT从业者？ 10w+人浏览 1.5k人参与

🧭 一、搭建目标

在 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

配置环境变量：

打开系统环境变量 → 编辑 Path → 新建：
```
G:\dev_environment\flutter3.35.7\bin
```
重新打开命令行，执行：
```
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

选择 Pixel 6
选择系统镜像（Android 13 / API 33）
点击 “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 应用