完整的 Flutter 开发环境搭建指南(最小化配置)

前言

本文详细介绍如何搭建一个资源占用较少但仍功能完整的 Flutter 开发环境,避免安装庞大的 Android Studio。

准备工作

Flutter SDK、Android SDK CMD、VSCode

1. Flutter SDK 安装步骤

  • 从官网下载 Flutter SDK
  • 将其解压到指定目录(例如 C:\src\flutter
  • 配置系统环境变量,将 flutter\bin 添加到 PATH 中
  • 使用 flutter doctor 命令验证安装是否成功

2. 最小化的 Android 组件配置

相比安装完整的 Android Studio,我们只需要安装必要的组件:

Android 命令行工具安装
  • 从 Android 开发者网站下载"仅命令行工具"
  • 解压到目标位置(例如 C:\android\sdk
必需的 SDK 包安装

使用 sdkmanager 工具安装以下必要组件:

sdkmanager "platform-tools" "platforms;android-30" "build-tools;30.0.3"
sdkmanager "emulator"
sdkmanager "system-images;android-30;google_apis;x86_64"
环境变量设置

配置以下环境变量确保 Flutter 能够找到 Android SDK:

  • ANDROID_SDK_ROOT = 指向你的 SDK 目录路径
  • ANDROID_HOME = 与 ANDROID_SDK_ROOT 相同(为了兼容性考虑)

3. Visual Studio Code 配置

  • 从官方网站下载并安装 VS Code
  • 安装 Flutter 扩展(会自动包含 Dart 扩展)
  • 在 VS Code 设置中配置 Flutter SDK 路径

Android 模拟器配置

创建虚拟设备

avdmanager create avd -n MyFlutterEmulator -k "system-images;android-30;google_apis;x86_64"

启动模拟器

emulator -avd MyFlutterEmulator

开发工作流程

项目创建

flutter create my_app
cd my_app

应用程序运行

  1. 手动启动模拟器或连接物理设备
  2. 在 VS Code 中按 F5 开始调试
  3. 或者使用终端命令:flutter run

VS Code 中的关键 Flutter 功能

  • 热重载(Hot Reload): Ctrl+F5 - 即时应用代码更改
  • 热重启(Hot Restart): Ctrl+Shift+F5 - 使用更新后的代码重启应用
  • 调试控制台(Debug Console): 实时日志记录和错误监控
  • Flutter 检查器(Flutter Inspector): 可视化组件树检查

常用键盘快捷键

快捷键功能
F5开始调试
Ctrl+F5不调试直接运行
Ctrl+\热重载
Ctrl+Shift+\热重启
Ctrl+Shift+P打开命令面板

验证与故障排除

检查安装状态

运行 flutter doctor 命令验证所有组件是否已正确配置。

常见问题及解决方案

  • 设备未被检测到: 确保 adb 在 PATH 中并运行 adb devices
  • 模拟器无法启动: 检查 Intel 处理器上的 HAXM 安装情况
  • 缺少许可证: 运行 flutter doctor --android-licenses 接受相关许可

这种最小化配置提供了完整的 Flutter 开发能力,同时比安装完整的 Android Studio 消耗更少的系统资源。

Logo

Agent 垂直技术社区,欢迎活跃、内容共建。

更多推荐