Menu
Article Flutter

Windows 安装配置 Flutter+Android Studio 开发环境

Gloary Lei

• 3 min read

Flutter 的安装看似简单，但在实际操作中，特别是涉及到 Android 环境配置时，往往充满了“坑”。本文将带您一步步完成安装，并将原本占用 C 盘几十 GB 的 SDK 和模拟器文件全部迁移至 D 盘，还你一个清爽的系统盘。

第一步：基础环境准备

1. 安装 Git

Flutter 依赖 Git 进行版本管理和依赖更新。

  • 访问 Git 官网 下载并安装最新版。
  • 安装过程中一路点击 "Next" 即可。

2. 配置国内镜像（关键！）

由于国内网络原因，直接下载 Flutter 依赖会非常慢甚至失败。我们需要配置环境变量使用国内镜像。

  1. 按 Win + S 搜索 “编辑系统环境变量”。
  2. 点击 “环境变量” -> “用户变量” -> “新建”。
  3. 添加以下两组变量：
变量名 变量值
PUB_HOSTED_URL https://pub.flutter-io.cn
FLUTTER_STORAGE_BASE_URL https://storage.flutter-io.cn

第二步：下载 Flutter SDK (D盘安装)

为了节省 C 盘空间，我们将 SDK 放在 D 盘。

  1. 下载：前往 Flutter 官网 下载最新的 Stable (稳定版) zip 包。
  2. 解压：在 D 盘新建目录（例如 D:\develop），将压缩包解压进去。
    • 注意：路径中严禁出现中文或空格。
    • 最终路径示例：D:\develop\flutter
  3. 配置 Path：
    • 再次打开 “环境变量” -> “用户变量” -> 找到 Path -> 编辑。
    • 新建一条，填入 bin 目录路径：D:\develop\flutter\bin。
  4. 验证：打开 CMD 或 PowerShell，输入 flutter --version，显示版本号即成功。

第三步：安装 Android Studio & SDK (D盘安装)

这是最容易出错的环节，请仔细操作。

  1. 下载：访问 Android Studio 中文官网 下载安装包。
  2. 自定义安装路径：
    • 运行安装程序，在 Install Type 界面，务必选择 Custom (自定义)。
    • 在 Android SDK Location 界面，将路径修改为 D 盘，例如：D:\Android\Sdk。
  3. 安装命令行工具（必做！）：
    • 安装完成并启动 Android Studio 后，点击 More Actions -> SDK Manager。
    • 切换到中间的 SDK Tools 标签页。
    • 勾选 Android SDK Command-line Tools (latest)。
    • 点击 Apply 下载安装。

第四步：Flutter 与 Android 的关联配置

因为我们将 SDK 装到了 D 盘，Flutter 默认可能找不到它。

1. 告诉 Flutter SDK 在哪

在终端执行：

flutter config --android-sdk "D:\Android\Sdk"

2. 同意 Android 协议

在终端执行：

flutter doctor --android-licenses
  • 一路输入 y 并回车，直到提示 All SDK package licenses accepted。

3. 安装 IDE 插件

如果不装插件，Android Studio 无法识别 Flutter 项目，会导致代码无法运行、没有“Run”按钮等问题。

  1. 打开 Android Studio -> Settings -> Plugins。
  2. 搜索 Flutter 并安装（它会自动安装 Dart）。
  3. 重启 IDE（必须重启才能生效）。

第五步：迁移模拟器文件 (.android) 到 D 盘

默认情况下，安卓模拟器（AVD）的文件会存放在 C:\Users\用户名\.android，每个模拟器占用约 10GB。我们要把它搬到 D 盘。

  1. 移动文件：
    • 关闭 Android Studio。
    • 在 D 盘创建目录，如 D:\AndroidConfig。
    • 配置环境变量：新建用户变量 ANDROID_USER_HOME，值为 D:\AndroidConfig\.android。
    • 将 C 盘的 .android 文件夹剪切并粘贴到 D:\AndroidConfig 下。
  2. 修改配置文件 (.ini)：
    • 进入 D:\AndroidConfig\.android\avd。
    • 用记事本打开所有 .ini 结尾的文件。
    • 找到 path= 这一行，将路径修改为新的 D 盘路径。
    • 示例：path=D:\AndroidConfig\.android\avd\Pixel_6.avd

第六步：运行你的第一个 App

1. 解决“找不到入口”的问题

如果在 Android Studio 中打开项目后，顶部的运行按钮是灰色的，或者 Select Device 没反应：

  • 切换视图：点击左上角的 Android 下拉框，切换为 Project。
  • 手动运行：找到 lib/main.dart，右键点击，选择 Run 'main.dart'。这样 IDE 会自动生成运行配置。
Share