在 Windows 上配置 Flutter 的 Android 开发环境

一、最终统一安装路径

本次所有环境统一路径，无中文、无空格、无特殊字符，极度稳定：

• Flutter 目录：E:\anzhuo\flutter

• Android SDK 目录：E:\anzhuo\Sdk

• JDK17 目录：E:\Java\jdk17

• Git：系统自带已安装（2.54.0 稳定版）

二、配置 Flutter 国内镜像

国内必须配置镜像，否则依赖下载失败、maven 超时、握手错误。以管理员 CMD 执行以下三条全局镜像配置：

setx FLUTTER_STORAGE_BASE_URL https://storage.flutter-io.cn /M setx PUB_HOSTED_URL https://pub.flutter-io.cn /M setx PATH "%PATH%;E:\anzhuo\flutter\bin" /M

配置完成后：关闭所有 CMD 重新打开

三、解决 Git 仓库权限报错

Windows 切换用户后会报 dubious ownership 可疑仓库权限，直接全局放行：

git config --global --add safe.directory E:/anzhuo/flutter git config --global --add safe.directory E:/*

四、安装与配置 JDK17

1、安装说明

新版 Flutter / Android SDK 必须依赖 JDK17，系统自带、Flutter 内置 JDK 均不稳定。安装路径：E:\Java\jdk17

2、配置系统环境变量（管理员CMD）

setx JAVA_HOME "E:\Java\jdk17" /M setx PATH "%JAVA_HOME%\bin;%PATH%" /M

3、验证 Java 环境

java -version

正常输出版本即为成功。

五、配置 Android SDK

1、创建目录

Android SDK 必须遵守谷歌目录规范，否则 sdkmanager 识别失败：

md E:\anzhuo\Sdk\cmdline-tools\latest

将 Android 命令行工具解压放入：E:\anzhuo\Sdk\cmdline-tools\latest

2、配置 SDK 全局环境变量

setx ANDROID_HOME E:\anzhuo\Sdk /M setx ANDROID_SDK_ROOT E:\anzhuo\Sdk /M setx PATH "%PATH%;E:\anzhuo\Sdk\platform-tools;E:\anzhuo\Sdk\cmdline-tools\latest\bin" /M

3、安装 Android 核心组件

sdkmanager --install platform-tools "platforms;android-34" "build-tools;34.0.0" echo y | sdkmanager --licenses

4、Flutter 绑定 Android SDK

flutter config --android-sdk E:\anzhuo\Sdk flutter doctor --android-licenses

全部输入 y 同意证书。

六、VSCode 开发环境配置

1、安装必备插件

• Flutter

• Dart

安装完成 彻底重启 VSCode（关键，否则环境不生效）

2、创建并运行 Flutter 项目

flutter create testapp cd testapp flutter run

手机开启 USB 调试连接电脑，即可正常编译安装 APK。