目录
- 核心工具选择
- 在 VS Code 中配置 Flutter 环境
- 下载与安装 Flutter SDK
- 解决 Android 环境配置问题
- 验证与后续步骤
1. 核心工具选择
Flutter 开发的核心是 Flutter SDK 配合一个强大的代码编辑器。官方推荐使用 Visual Studio Code (VS Code) 或 Android Studio，两者各有侧重。
| 工具 | 类型 | 适用人群 | 核心优势 |
|---|---|---|---|
| Visual Studio Code | 轻量级编辑器 | 前端/全栈开发者、追求极速启动 | 启动快、内存占用低、插件生态丰富、热重载体验流畅 |
| Android Studio | 集成开发环境 (IDE) | Android 原生开发者、大型项目 | 官方首推、功能最全（含模拟器、性能分析工具）、调试能力强大 |
选择建议:
- 新手入门：建议从 VS Code 开始，配置简单，能更快体验 Flutter 的热重载魔力。
- 企业级开发：推荐使用 Android Studio，其集成的性能分析器和 UI 检查器对复杂项目至关重要。
2. 在 VS Code 中配置 Flutter 环境
以下是在 VS Code 中搭建 Flutter 开发环境的详细步骤：
步骤一：安装 VS Code
- 下载：前往 VS Code 官网下载并安装。
- 注意：在 Windows 上，建议使用 User Setup 安装方式，无需管理员权限，更新更便捷。
步骤二：安装 Flutter 与 Dart 插件
- 打开 VS Code，进入扩展市场 (
Ctrl+Shift+X)。 - 搜索并安装官方 Flutter 扩展，它通常会提示一并安装 Dart 插件。
- 重启 VS Code 使插件生效。
步骤三：创建并运行第一个项目
-
创建项目：按
Ctrl+Shift+P打开命令面板，输入并选择Flutter: New Project，按指引创建。 -
运行项目：
- 连接安卓手机（需开启 USB 调试）或启动模拟器。
- 在 VS Code 底部状态栏选择目标设备。
- 按
F5或点击“启动调试”运行项目。
-
体验热重载：修改代码后保存 (
Ctrl+S)，UI 将立即更新。
3. 下载与安装 Flutter SDK
下载 Flutter SDK
- 官方渠道 (推荐) ：访问 Flutter 官网下载对应操作系统的稳定版 SDK 压缩包。
- 国内镜像 (如访问慢) ：可使用清华大学开源镜像站等国内源加速下载。
配置环境变量
-
解压：将下载的 SDK 解压到无中文、无空格的路径，例如：
- Windows:
C:\src\flutter - macOS/Linux:
~/development/flutter/
- Windows:
-
添加 PATH：将 SDK 下的
bin目录（如C:\src\flutter\bin）添加到系统的PATH环境变量中。 -
验证：打开新终端，运行
flutter --version，如能输出版本信息则配置成功。
4. 解决 Android 环境配置问题
运行 flutter doctor是检查环境的关键。最常见的报错集中在 Android toolchain 部分。下图是一个典型的配置问题示例：
`[✗] Android toolchain - develop for Android devices
✗ cmdline-tools component is missing
✗ Android license status unknown.`
问题诊断与解决方案
问题1：缺少 cmdline-tools组件
原因：Flutter 构建需要 Android SDK 的命令行工具。
解决方案：
-
通过 Android Studio 安装（推荐） ：
- 打开 Android Studio，点击顶部菜单 Tools -> SDK Manager。
- 切换到 SDK Tools 标签页。
- 勾选 Android SDK Command-line Tools (latest) ，点击 Apply 安装。
-
手动安装：从 Android 开发者网站下载命令行工具包，解压到 SDK 目录的
cmdline-tools/latest/文件夹下。
问题2：Android 许可证状态未知
原因：未接受 Android SDK 的许可协议。
解决方案：
在终端中运行以下命令，并一直按 y键确认所有协议：
flutter doctor --android-licenses
问题3：无法定位 Android SDK
原因：flutter doctor找不到 Android SDK 的安装路径。
解决方案：
-
确认路径：在 Android Studio 的 SDK Manager 中查看 SDK 的安装路径。
-
设置环境变量：
- 添加系统环境变量
ANDROID_HOME，值为你的 SDK 路径（如C:\Users\YourName\AppData\Local\Android\Sdk）。 - 或者在终端中运行：
flutter config --android-sdk "你的SDK路径"。
- 添加系统环境变量
5. 验证与后续步骤
完成所有配置后，再次运行 flutter doctor，理想的结果应如下图所示：
`[✓] Flutter (Channel stable, 3.x.x, ...)
[✓] Android toolchain - develop for Android devices (Android SDK version 34.0.0)
[✓] Chrome - develop for the web
[✓] Visual Studio - develop for Windows (Visual Studio 2022 17.x)
[✓] Connected device (3 available)
[✓] Network resources`
恭喜！ 当所有主要项目前都显示为绿色的对勾 [✓]时，你的 Flutter 开发环境就已完全配置成功。
开始你的第一个项目
现在，你可以回到 VS Code，使用 Flutter: New Project命令创建新应用，尽情享受 Flutter 高效、愉悦的开发体验吧！
