Flutter Android Studio 环境配置完整指南适用环境华为 MateBook D16 · Windows 11版本Flutter 3.24.4 · Android Studio 2024.3.2作者按本文记录了从零开始完整配置 Flutter Android Studio 开发环境的全过程包含了我个人的一些踩坑经历供参考。目录前置准备安装 Android Studio配置 Java 环境安装 Flutter SDK配置环境变量运行 flutter doctor安装 MySQL按需在 Android Studio 中配置 Flutter 插件创建并运行第一个 Flutter 项目常见问题与踩坑记录一、前置准备在开始配置之前请确认以下事项操作系统Windows 10 / 1164位可用磁盘空间建议预留20 GB以上Android SDK 较大网络环境部分资源需要访问境外服务器建议提前准备好代理工具或使用国内镜像源管理员权限安装过程中需要以管理员身份运行部分操作划重点二、安装 Android Studio2.1 下载前往 Android Studio 官方下载页面https://developer.android.google.cn/studio选择Android Studio 2025.3.2Meerkat 版本下载.exe安装包。 建议使用 Android Studio 官方中国镜像 下载速度更快。2.2 安装双击安装包按提示完成安装向导安装路径建议使用默认路径或选择一个不含中文和空格的路径安装完成后首次启动会引导下载 Android SDK2.3 下载 Android SDK首次启动 Android Studio 时Setup Wizard 会自动引导配置选择Standard安装类型SDK 默认安装路径为C:\Users\用户名\AppData\Local\Android\Sdk等待 SDK 下载完成如果使用镜像网站且网速比较快的话会下载挺快的安装完成后记录下 Android SDK 的安装路径准备配置环境变量。三、配置 Java 环境3.1 Android Studio 内置 JDKAndroid Studio 2022.2 及以上版本已内置 JDK位于安装目录的jbr文件夹通常无需单独安装 Java。3.2 JAVA_HOME 配置重要☠☠踩坑记录ERROR: JAVA_HOME is set to an invalid directory如果你的电脑曾经安装过 Java后来又移动了 JDK 的安装目录就可能遇到此报错。系统环境变量中的JAVA_HOME路径已失效但变量本身仍然存在导致 Android Studio / Gradle 无法找到 Java 运行时。解决方案重新安装 JDK 并更新JAVA_HOME环境变量指向新的安装路径推荐使用 Android Studio 内置 JDK 路径。推荐直接使用Android Studio内置的JDK使用方法如下File → Settings → Build, Execution, Deployment → Build Tools → Gradle四、安装 Flutter SDK4.1 下载 Flutter SDK前往 Flutter 官方下载页面https://flutter.dev/docs/get-started/install/windows或使用国内镜像推荐https://flutter.cn/docs/get-started/install/windows下载Flutter 3.24.4稳定版压缩包.zip格式。4.2 解压安装将压缩包解压到一个不含中文、空格和特殊字符的路径例如D:\Program_Files\flutter解压完成后记录 Flutter 的根目录路径如D:\Program_Files\flutter五、配置环境变量5.1 添加 Flutter 到 PATH打开「系统环境变量」编辑界面在「系统变量」的Path中新增以下路径这里一定要依据实际情况写D:\Program_Files\flutter\bin5.2 配置 Android SDK 路径新建系统变量变量名变量值我的ANDROID_HOMEC:\Users\21426\AppData\Local\Android\Sdk在Path中追加%ANDROID_HOME%\cmdline-tools\latest\bin %ANDROID_HOME%\platform-tools5.3 配置国内镜像若网络访问受限可配置 Flutter 国内镜像添加以下系统变量变量名变量值PUB_HOSTED_URLhttps://pub.flutter-io.cnFLUTTER_STORAGE_BASE_URLhttps://storage.flutter-io.cn5.4 验证环境变量打开新的命令提示符窗口必须是新窗口否则环境变量不会刷新执行flutter--version若能正常输出 Flutter 版本信息说明路径配置成功。六、运行 flutter doctor6.1 执行诊断在命令提示符中运行flutter doctor正常输出示例Doctor summary (to see all details, run flutter doctor -v): [✓] Flutter (Channel stable, 3.24.4, ...) [✓] Windows Version (Windows 11) [✓] Android toolchain - develop for Android devices (Android SDK version xx.x.x) [✓] Android Studio (version 2025.3) [✓] VS Code (version x.x.x) [!] Visual Studio - develop Windows apps [✓] Connected device (x available) [✓] Network resources6.2 关于 Visual Studio 警告可忽略运行flutter doctor后可能会看到如下警告[!] Visual Studio - develop Windows apps (Visual Studio Community 2022 17.14.x) ✗ Visual Studio is missing necessary components. Please re-run the Visual Studio installer for the Desktop development with C workload, and include these components: MSVC v142 - VS 2019 C x64/x86 build tools C CMake tools for Windows Windows 10 SDK说明此警告仅影响将应用编译为Windows 桌面程序.exe的能力如果没有这方面的需求可以完全忽略此警告不影响正常的 Flutter Android 开发工作流。若确实需要编译 Windows 应用请打开 Visual Studio Installer勾选「使用 C 的桌面开发」工作负载并确保安装上述三个组件。这里需要注意的是,如果要安装上述组件的话要注意看Visual Studio Installer原定的安装路径是否有足够的空间Visual Studio Installer不支持修改存储路径。空间如果不够的话需要卸载重装Visual Studio Installer。6.3 接受 Android 许可证如果看到如下提示[!] Android toolchain ✗ Android licenses not accepted.执行以下命令并逐一同意许可协议flutter doctor --android-licenses七、安装 MySQL按需背景在运行flutter doctor之前并未意识到某些后端联调场景需要本地 MySQL 服务。在实际开发中运行项目时才发现连接数据库失败。因此建议有后端开发需求的同学提前安装好 MySQL。7.1 下载 MySQL前往 MySQL 官网下载社区版https://dev.mysql.com/downloads/mysql/推荐下载MySQL 8.0.x版本的 Windows Installer.msi。7.2 安装步骤运行安装程序选择Developer Default安装类型按向导提示安装依赖如 Visual C Redistributable配置 MySQL Server端口默认3306设置 root 用户密码务必牢记配置 Windows Service建议设为开机自启7.3 验证安装打开命令提示符mysql-uroot-p输入密码后进入 MySQL 命令行说明安装成功。7.4 添加 MySQL 到环境变量可选若希望在任意目录使用mysql命令将以下路径添加到系统PathD:\Program_Files\mysql-8.0.45-winx64\bin八、在 Android Studio 中配置 Flutter 插件8.1 安装 Flutter 和 Dart 插件打开 Android Studio进入File→Settings或Ctrl Alt S选择Plugins→Marketplace搜索Flutter点击安装Dart 插件会随 Flutter 插件自动安装安装完成后重启 Android Studio8.2 配置 Flutter SDK 路径进入File→Settings→Languages Frameworks→Flutter在Flutter SDK path中填入 Flutter 的根目录路径例如D:\development\flutter点击 OK 保存8.3 配置 Android SDK进入File→Settings→Appearance Behavior→System Settings→Android SDK确认 SDK 路径正确在SDK Platforms标签页中安装目标 Android 版本推荐安装 Android 13 / API 33 或以上在SDK Tools标签页中确认以下工具已安装Android SDK Build-ToolsAndroid EmulatorAndroid SDK Platform-Tools九、创建并运行第一个 Flutter 项目9.1 新建项目在 Android Studio 欢迎界面选择New Flutter Project选择Flutter项目类型确认 Flutter SDK 路径正确填写项目名称只能小写字母、数字和下划线、项目路径等信息点击Create创建项目9.2 获取依赖项目创建后在终端或 Android Studio 内置 Terminal 中运行flutter pub get9.3 启动项目由于我们已经有基础项目框架了我这里直接打开项目启动flutter pub get flutter run十、常见问题与踩坑记录问题一命令行出现光标闪烁但无任何输出现象在终端执行flutter run后光标持续闪烁没有任何日志输出程序挂起。排查方向① 检查 Flutter 是否正确安装flutter doctor-v查看详细输出确认 Flutter SDK 路径、Dart 版本、Android 工具链均无报错。② 检查是否有未完全终止的 Flutter 进程Flutter 进程在异常退出后可能不会完全释放缓存锁导致下次运行时被阻塞。解决方案删除项目根目录下以下文件/文件夹这些均为自动生成的缓存删除后不影响源代码build/ .dart_tool/ .flutter-plugins .flutter-plugins-dependencies然后重新获取依赖flutter pub get再次尝试运行flutter run也可以通过任务管理器手动结束所有dart.exe和flutter_tools.snapshot相关进程。问题二ERROR: JAVA_HOME is set to an invalid directory现象ERROR: JAVA_HOME is set to an invalid directory: C:\...\jdk\...\jre Please set the JAVA_HOME variable in your environment to match the location of your Java installation.原因分析电脑上曾经安装过 JDK后来文件被移动或卸载但JAVA_HOME环境变量仍指向旧路径。解决方案重新安装 JDK推荐直接使用 Android Studio 内置 JDK路径为C:\Program Files\Android\Android Studio\jbr更新系统环境变量JAVA_HOME指向新的 JDK 路径重启命令提示符或重启电脑后验证java-versionecho%JAVA_HOME%问题三Visual Studio 组件缺失警告现象flutter doctor输出中出现[!] Visual Studio警告提示缺少 C 工作负载。去下载相关组件的时候又提示C盘容量不足最开始学习和安装的时候没有分盘的概念所以把Visual Studio的安装路径放在默认位置了结论如无需编译 Windows 桌面应用.exe此警告可以忽略不影响 Android 开发。如需修复打开 Visual Studio Installer → 修改 → 勾选「使用 C 的桌面开发」→ 确保勾选以下组件MSVC v142 - VS 2019 C x64/x86 生成工具最新版本用于 Windows 的 C CMake 工具Windows 10 SDK问题四flutter pub get 报网络错误现象执行flutter pub get时报连接超时或无法解析主机。解决方案配置国内 Flutter 镜像源参见 第五节 5.3在系统环境变量中设置PUB_HOSTED_URLhttps://pub.flutter-io.cn FLUTTER_STORAGE_BASE_URLhttps://storage.flutter-io.cn问题五Android licenses not accepted现象flutter doctor提示 Android 许可证未接受。解决方案flutter doctor --android-licenses按提示输入y逐一同意所有许可协议即可。总结至此Flutter Android Studio 的开发环境就配置完成了。整体流程梳理如下安装 Android Studio完成 SDK 下载配置 JAVA_HOME避免 JDK 路径失效问题下载并解压 Flutter SDK 到无中文无空格的目录配置系统环境变量Flutter bin、Android SDK、镜像源运行flutter doctor排查并修复环境问题在 Android Studio 安装 Flutter 插件绑定 SDK 路径启动项目着重补充如果在Android Studio运行命令之后出现光标闪烁无输出的情况一定要考虑是不是有之前没完全关闭的flutter项目导致锁被占用了。从gitee上拉取新项目之后记得重新flutter pub get。