📱 Flutter开发环境配置

本教程将指导你配置Flutter开发环境。如果遇到问题，可以参考Flutter官方安装文档。

⚙️ 准备工作
1
检查电脑配置

确保你的电脑满足以下基本要求：

  • Windows 10 或更高版本（64位系统）
  • 至少8GB内存（推荐16GB）
  • 至少50GB可用存储空间

⚠️ 警告：

下面所有开发环境的安装路径不能包含任何中文字符，请选择纯英文路径进行安装！

💡 提示：如果你的电脑是近几年购买的，通常都能满足硬件要求

🤖 安装Android Studio
1
下载Android Studio

访问Android Studio官网下载最新版本。

💡 小提示：

  • 下载时选择Windows版本
  • 如果下载速度较慢，可以使用国内镜像站
2
安装Android Studio
  1. 双击下载的安装文件
  2. 全部使用默认选项，一路点击"Next"
  3. 安装完成后启动Android Studio
安装过程可能需要20-30分钟，这是正常的。期间请保持网络连接。
3
安装必要的SDK组件
  1. 在Android Studio主界面，点击"Tools" → "SDK Manager"
  2. 在打开的"Settings"窗口中：
    • 首先在"SDK Platforms"标签页：
      • 勾选"Android SDK Platform, API 35.0.1"（或其他稳定版本，通常选择列表中第二或第三新的版本即可）
      • 勾选"Show Package Details"可以看到详细选项
    • 然后切换到"SDK Tools"标签页，勾选：
      • Android SDK Command-line Tools
      • Android SDK Build-Tools
      • Android SDK Platform-Tools
      • Android Emulator
  3. 点击"Apply"开始安装
  4. 在弹出的确认窗口中点击"OK"

💡 重要提示：

  • 这些组件是Flutter开发必需的，缺少任何一个都可能导致开发环境不完整
  • 下载和安装过程可能需要20-30分钟，这是正常的
  • 如果下载很慢，可以考虑使用国内镜像源
4
同意Android许可证

打开命令提示符（以管理员身份运行），执行：

flutter doctor --android-licenses

对所有许可提示输入"y"并回车。

💡 说明：

  • 这一步必须在Android SDK安装完成后立即执行
  • 如果提示找不到flutter命令，请确保已经完成了Flutter的安装和环境变量配置
📦 安装Flutter
1
下载Flutter SDK

访问Flutter官网下载最新的稳定版SDK。

下载完成后：

  1. 在C盘根目录创建一个名为"dev"的文件夹
  2. 将下载的zip文件解压到C:\dev目录下
  3. 解压后应该能看到C:\dev\flutter文件夹
2
配置国内镜像

1. 修改Maven仓库地址：

  • 打开 flutter/packages/flutter_tools/lib/src/http_host_validator.dart 文件
  • 找到 kMaven 变量（原值为 https://maven.google.com）
  • 将其值替换为：https://maven.aliyun.com/repository/google
  • 删除 flutter sdk 目录下的 bin/cache 文件夹（例如：C:\dev\flutter\bin\cache）

2. 配置Flutter和Pub镜像：

  1. 按下Win + R，输入"sysdm.cpl"并回车
  2. 切换到"高级"标签
  3. 点击"环境变量"
  4. 在"用户变量"区域点击"新建"，添加以下两个环境变量：
FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
PUB_HOSTED_URL=https://pub.flutter-io.cn

💡 说明：

  • 这些配置可以让Flutter使用国内镜像源，大幅提升下载速度
  • FLUTTER_STORAGE_BASE_URL：用于下载Flutter引擎、工具等二进制文件
  • PUB_HOSTED_URL：用于下载Dart包（类似于npm仓库）
3
配置环境变量
  1. 按下Win + R，输入"sysdm.cpl"并回车
  2. 切换到"高级"标签
  3. 点击"环境变量"
  4. 在"用户变量"区域找到"Path"
  5. 点击"编辑"→"新建"
  6. 输入"C:\dev\flutter\bin"
  7. 连续点击"确定"保存设置
📱 配置Android模拟器
1
创建虚拟设备
  1. 在Android Studio中打开Device Manager：
    • 如果已打开项目：Tools > Device Manager
    • 如果在欢迎界面：More Actions > Virtual Device Manager
  2. 点击"Create Device"
  3. 选择设备类型：
    • 在Category中选择"Phone"
    • 选择一个设备（如Pixel 2）
    • 点击"Next"
  4. 选择系统镜像：
    • 切换到"x86 Images"标签
    • 选择一个Android版本（推荐最新的稳定版）
    • 如果有Download按钮，点击下载
    • 下载完成后点击"Next"
  5. 保持默认配置，点击"Finish"完成创建

💡 提示：

  • 首次下载系统镜像可能需要较长时间，请保持网络连接
  • 如果你有Android手机，也可以使用真机调试
2
启动模拟器

在Device Manager中，点击创建的虚拟设备右侧的运行按钮（三角形图标）即可启动模拟器。

首次启动可能需要几分钟，这是正常的。后续启动会更快。
✅ 验证安装
1
检查环境

打开一个新的命令提示符窗口（Win + R，输入cmd），运行：

flutter doctor

系统会检查你的环境并显示类似下面的报告：

Running flutter doctor...
Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, 3.27.0, on Microsoft Windows [Version 10.0])
[✓] Windows version (Installed version of Windows is version 10 or higher)
[✓] Android toolchain - develop for Android devices (Android SDK version 35.0.1)
[!] Chrome - develop for the web
[!] Visual Studio - develop Windows apps
[✓] Android Studio (version 2024.2)
[✓] VS Code (version 1.95)
[✓] Connected device (1 available)
[✓] Network resources

! Doctor found issues in 2 categories.

💡 检查结果说明：

必须显示打勾(✓)的项目：

  • Flutter - Flutter SDK安装状态
  • Windows version - Windows系统版本
  • Android toolchain - Android开发工具
  • Android Studio - 开发工具安装状态

可以显示感叹号(!)的项目：

  • Chrome - 仅用于Web开发，可以忽略
  • Visual Studio - 仅用于Windows开发，可以忽略
  • Connected device - 稍后配置模拟器就会解决
  • Network resources - 网络连接状态检查，如果显示maven.google.com超时错误可以忽略，因为我们已经配置了国内镜像
遇到问题？
目录