前言这篇文章记录了我从零开始在 Windows 10 上搭建 Flutter Android 开发环境的全过程。期间踩了不少坑我把遇到的问题和解决方案都整理出来希望能帮你少走弯路。一、环境概述项目版本/信息操作系统Windows 10 企业版 LTSC 21H2Flutter SDK3.44.9 (stable)JavaOpenJDK 17 (Temurin)Android SDKAPI 35 / 36IDEVS Code目标设备Android 真机 / 模拟器二、下载与安装2.1 Flutter SDK下载地址官方https://docs.flutter.dev/install国内镜像推荐https://flutter.cn安装步骤下载flutter_windows_xxx-stable.zip解压到F:\flutter_windows_3.44.9-stable\flutter路径中不要有中文和空格将bin目录添加到系统环境变量Path中2.2 Java JDK 17下载地址https://adoptium.net/temurin/releases/选择Operating System: WindowsArchitecture: x64Version: 17 (LTS)Package Type: JDK⚠️重要提示不要安装 Java 25 或更高版本Android SDK 工具只兼容 Java 17。2.3 Android 命令行工具下载地址国内镜像https://dl.google.com/android/repository/commandlinetools-win-11076708_latest.zip如果打不开官网也可以用https://googledownloads.cn/android/repository/commandlinetools-win-11076708_latest.zip安装步骤创建目录C:\AndroidSdk解压 zip 包确保路径为C:\AndroidSdk\cmdline-tools\latest\bin\sdkmanager.bat2.4 VS Code 扩展在 VS Code 中安装Flutter扩展Dart 会自动安装。三、环境变量配置3.1 必需的系统变量变量名变量值ANDROID_SDK_ROOTC:\AndroidSdkJAVA_HOMEC:\Program Files\Eclipse Adoptium\jdk-17.0.xx-hotspot3.2 Path 中添加的路径C:\AndroidSdk\cmdline-tools\latest\bin C:\AndroidSdk\platform-tools C:\AndroidSdk\emulator F:\flutter_windows_3.44.9-stable\flutter\bin操作方式右键此电脑 → 属性 → 高级系统设置 → 环境变量 → 系统变量四、安装 Android SDK 组件打开 PowerShell依次执行# 1. 安装平台工具C:\AndroidSdk\cmdline-tools\latest\bin\sdkmanager.batplatform-tools# 2. 安装 Android 35 平台C:\AndroidSdk\cmdline-tools\latest\bin\sdkmanager.batplatforms;android-35# 3. 安装模拟器C:\AndroidSdk\cmdline-tools\latest\bin\sdkmanager.batemulator# 4. 安装系统镜像C:\AndroidSdk\cmdline-tools\latest\bin\sdkmanager.batsystem-images;android-35;google_apis;x86_64# 5. 接受所有许可协议C:\AndroidSdk\cmdline-tools\latest\bin\sdkmanager.bat--licenses⏱️ 下载需要一定时间请耐心等待进度条完成。五、创建并启动模拟器# 1. 列出可用设备型号C:\AndroidSdk\cmdline-tools\latest\bin\avdmanager.bat list device# 2. 创建模拟器C:\AndroidSdk\cmdline-tools\latest\bin\avdmanager.bat create avd-n myPixel-ksystem-images;android-35;google_apis;x86_64-d pixel_xl# 3. 启动模拟器C:\AndroidSdk\emulator\emulator.exe-avd myPixel-feature WindowsHypervisorPlatform六、验证环境flutter doctor-v正常输出应该看到所有项目都是[√]或[!]警告可忽略。flutter devices应该能看到你的 Android 设备或模拟器。七、创建并运行 Flutter 项目# 1. 创建项目flutter create my_first_app# 2. 进入项目目录cd my_first_app# 3. 运行flutter run八、常见问题与解决方案问题 1sdkmanager 不是内部或外部命令原因命令行工具没有添加到 PATH。解决使用完整路径运行或将C:\AndroidSdk\cmdline-tools\latest\bin添加到系统 Path 中。问题 2Error: A JNI error has occurred... class file version 61.0原因Java 版本不对SDK 工具需要 Java 17但你用的是 Java 8。解决卸载旧版本 Java安装 OpenJDK 17。java-version# 确认版本为 17问题 3PANIC: CPU Architecture arm is not supported原因AVD 配置文件中的 CPU 架构与镜像不匹配。解决手动修改config.ini文件C:\Users\你的用户名\.android\avd\myPixel.avd\config.ini修改或添加hw.cpu.arch x86_64 hw.cpu.model qemu64问题 4adb server version doesnt match this client原因电脑上存在多个版本的 ADB如手机助手自带。解决# 1. 找到所有 ADBwhere adb# 2. 杀掉所有 ADB 进程taskkill/f/im adb.exe# 3. 只用你下载的 ADBC:\AndroidSdk\platform-tools\adb.exestart-server建议检查系统 Path删除指向旧 ADB 的路径。问题 5模拟器显示offline原因ADB 连接状态异常。解决C:\AndroidSdk\platform-tools\adb.exekill-server C:\AndroidSdk\platform-tools\adb.exestart-serverC:\AndroidSdk\platform-tools\adb.exe devices问题 6flutter devices看不到模拟器或手机原因Flutter 没有读取到 Android SDK 路径。解决在 PowerShell 中临时设置$env:ANDROID_SDK_ROOT C:\AndroidSdk$env:PATH C:\AndroidSdk\platform-tools;$env:PATHflutter devices或者在 VS Code 底部状态栏直接选择设备。问题 7Timeout waiting to lock build logic queue原因Gradle 构建锁被其他进程占用。解决# 杀掉占用进程taskkill/PID 6884/F# 删除锁文件Remove-Item-Path项目路径\android\.gradle\noVersion\buildLogic.lock-Force# 清理后重试flutter clean flutter run问题 8Gradle 下载依赖太慢原因默认从国外仓库下载。解决修改android/build.gradle.kts添加阿里云镜像allprojects{repositories{maven{urluri(https://maven.aliyun.com/repository/public)}maven{urluri(https://maven.aliyun.com/repository/google)}maven{urluri(https://maven.aliyun.com/repository/gradle-plugin)}google()mavenCentral()}}问题 9VS Code 提示找不到 Flutter SDK原因dart.flutterSdkPath配置不正确。解决在settings.json中添加{dart.flutterSdkPath:F:\\flutter_windows_3.44.9-stable\\flutter}九、总结完整的环境构成Flutter SDK Java 17 Android SDK VS Code 模拟器/真机关键经验环境变量是灵魂一定要配好ANDROID_SDK_ROOTJava 版本必须用 17别用 25网络慢时记得配置 Gradle 镜像遇到 ADB 问题先杀进程再重启服务PowerShell 比 CMD 更好用环境变量语法不同十、常用命令速查命令用途flutter doctor -v检查环境状态flutter devices列出可用设备flutter emulators列出模拟器flutter emulators --launch myPixel启动模拟器flutter create 项目名创建项目flutter run运行项目flutter clean清理构建缓存adb devices查看 ADB 连接设备adb kill-server重启 ADB 服务希望这篇文章能帮你顺利完成 Flutter 开发环境的搭建。如果有其他问题欢迎留言交流