Windows Flutter Android Studio开发环境配置

一、基础环境准备

1. ‌系统要求‌

   • Windows 10/11 64位系统
   • 至少4GB内存，推荐8GB以上
   • 磁盘空间≥8GB（含IDE和SDK）‌

2. ‌必要工具‌

   • Git for Windows（需勾选"Use Git from Windows Command Prompt"）‌
   • PowerShell 5.0+（系统自带）‌

二、核心组件安装

1. ‌Flutter SDK配置‌

• ‌下载地址‌：Flutter官网
• ‌安装步骤‌：
  1. 解压到无空格/中文路径（如D:\sdk\flutter）
  2. 添加环境变量：

     Path → 新增：D:\sdk\flutter\bin

  3. 国内用户需添加镜像变量：

     FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn PUB_HOSTED_URL=https://pub.flutter-io.cn

2. ‌JDK安装‌

• ‌推荐版本‌：JDK 17（兼容Android Studio 2023+）
• ‌配置变量‌：

  JAVA_HOME → C:\Program Files\Java\jdk-17.0.8 Path → 新增：%JAVA_HOME%\bin

3. ‌Android Studio配置‌

1. 安装时勾选：
   • Android SDK
   • Android SDK Command-line Tools
   • Intel HAXM（虚拟机加速）‌
2. 启动后安装插件：
   • Flutter
   • Dart（自动关联安装）‌
3. 配置SDK路径变量：

   ANDROID_HOME → C:\Users\你的用户名\AppData\Local\Android\Sdk Path → 新增：%ANDROID_HOME%\platform-tools

三、环境验证与问题排查(环境变量配置完成后请重启)

1. ‌运行诊断命令‌：

   flutter doctor

   • 若提示Android许可未接受，执行：

     flutter doctor --android-licenses 

2. ‌常见问题解决‌：
   • ‌Gradle卡顿‌：修改gradle-wrapper.properties：

     distributionUrl=https://mirrors.cloud.tencent.com/gradle/gradle-7.6.3-all.zip

   • ‌依赖下载慢‌：在build.gradle添加阿里云镜像：

     maven { url 'https://maven.aliyun.com/repository/public' }

四、开发工具推荐

1. ‌VS Code扩展‌：
   • Flutter
   • Dart
   • Awesome Flutter Snippets‌
2. ‌设备管理‌：
   • 通过Android Studio创建AVD（推荐Pixel 5 + API 33）

五、常见问题处理

    Flutter Doctor:

• ‌Unable to locate Android SDK‌：配置Android_HOME SDK环境变量,参照Android环境配置
• Android toolchain - develop for Android devices (Android SDK version 36.0.0): 在控制台运行命令 flutter doctor --android-licenses
• cmdline-tools component is missing:  开Android Studio → Tools → SDK Manager在SDK Tools选项卡中勾选：Android SDK Command-line Tools 
  点击Apply安装‌
• 
• Some Android licenses not accepted. To resolve this, run: flutter doctor --android-licenses:  
  flutter doctor --android-licenses
• Dart SDK is not configured: 在 File > Settings > Languages & Frameworks > Dart 中手动指定路径, 通常为 flutter/bin/cache/dart-sdk (例如D:\sdk\flutter\bin\cache\dart-sdk）‌。
• Error: Unable to find git in your PATH.:既存git目录非当前用户,需要执行git config --global --add safe.directory '*'

注意事项

• 所有路径避免中文和空格
• 配置完成后需重启终端或IDE使变量生效‌
• 首次运行flutter pub get可能较慢，建议使用稳定网络环境