Topwo博客-搭建flutter和dart的开发环境

您现在的位置是：Topwo博客>>Android文章

搭建flutter和dart的开发环境

发布时间：2026-01-09作者：Topwo来源：原创点击：173

# Flutter + Dart 开发环境搭建（适配 Java 8 + Gradle 7.0.2 + Android Studio Arctic Fox）
基于你已有的 **Java 8、Gradle 7.0.2、Android Studio Arctic Fox 2020.3.1 Patch 2** 环境，以下是完整的 Flutter + Dart 环境搭建步骤，包含兼容性配置、环境变量设置、IDE 插件安装及验证流程。

## 一、 环境兼容性确认
你的现有工具版本与 Flutter 兼容，但需注意：
- **Flutter 推荐版本**：选择 **Flutter 3.0.x ~ 3.7.x**（更高版本可能对 Gradle 7.0.2 兼容性下降）
- **核心约束**
  - Java 8 是 Flutter 安卓编译的推荐版本（无需升级）
  - Gradle 7.0.2 需与 Android Gradle Plugin（AGP）匹配（Arctic Fox 默认 AGP 7.0.4，完美兼容 Gradle 7.0.2）

## 二、 步骤1：下载 Flutter SDK
1.  访问 [Flutter 官方下载页](https://flutter.dev/docs/development/tools/sdk/releases)，选择 **Flutter 3.7.12**（稳定版，兼容性最优）
    - 选择对应系统版本（Windows/macOS/Linux）
2.  解压下载的压缩包到**无中文、无空格**的目录，例如：
    - Windows：`D:\dev\flutter`
    - macOS/Linux：`/usr/local/dev/flutter`

## 三、 步骤2：配置系统环境变量
### Windows 系统
1.  右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
2.  **用户变量** 中新建/编辑：
    - 新建变量 `FLUTTER_HOME`，值为 Flutter 解压路径（如 `D:\dev\flutter`）
    - 编辑 `Path` 变量，添加两条路径：
      ```
      %FLUTTER_HOME%\bin
      %FLUTTER_HOME%\bin\cache\dart-sdk\bin  # Dart SDK 已内置，无需单独下载
      ```
3.  **系统变量** 中确认 `JAVA_HOME`：
    - 变量值为 Java 8 的安装路径（如 `C:\Program Files\Java\jdk1.8.0_xxx`）
    - 确保 `Path` 中包含 `%JAVA_HOME%\bin`

### macOS/Linux 系统
1.  打开终端，编辑配置文件（根据 Shell 类型选择）：
    - Bash：`~/.bash_profile`
    - Zsh：`~/.zshrc`
2.  添加以下内容：
    ```bash
    # Flutter 环境
    export FLUTTER_HOME=/usr/local/dev/flutter
    export PATH=$FLUTTER_HOME/bin:$PATH
    # Dart 环境（内置）
    export PATH=$FLUTTER_HOME/bin/cache/dart-sdk/bin:$PATH
    # Java 8 环境
    export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk1.8.0_xxx.jdk/Contents/Home
    ```
3.  执行命令生效配置：
    ```bash
    source ~/.bash_profile  # Bash
    source ~/.zshrc         # Zsh
    ```

## 四、 步骤3：配置 Gradle 环境（复用已下载的 Gradle 7.0.2）
1.  找到你已有的 `gradle-7.0.2-bin.zip`，解压到**无中文无空格**目录，例如 `D:\dev\gradle-7.0.2`（Windows）
2.  **配置 Gradle 环境变量**
    - Windows：新建系统变量 `GRADLE_HOME`，值为解压路径；`Path` 中添加 `%GRADLE_HOME%\bin`
    - macOS/Linux：在配置文件中添加 `export GRADLE_HOME=/usr/local/dev/gradle-7.0.2` 和 `export PATH=$GRADLE_HOME/bin:$PATH`
3.  **配置 Android Studio 优先使用本地 Gradle**
    - 打开 Android Studio，进入「File → Settings → Build, Execution, Deployment → Build Tools → Gradle」
    - 选择「Use local Gradle distribution」
    - Gradle home 填写你的 Gradle 7.0.2 路径（如 `D:\dev\gradle-7.0.2`）
    - 点击「Apply」→「OK」

## 五、 步骤4：Android Studio 配置 Flutter/Dart 插件
1.  打开 Android Studio Arctic Fox
2.  进入「File → Settings → Plugins」（Windows）/「Android Studio → Settings → Plugins」（macOS）
3.  点击「Marketplace」，搜索并安装以下两个插件：
    - **Flutter**（官方插件，提供项目创建、调试、热重载功能）
    - **Dart**（官方插件，提供语法高亮、代码补全）
4.  安装完成后重启 Android Studio

## 六、 步骤5：运行 Flutter 环境检查命令
1.  打开终端/命令提示符，执行以下命令：
    ```bash
    flutter doctor
    ```
2.  该命令会检查所有依赖项，并输出问题和修复建议，常见问题及解决：
    - **问题1：Android licenses not accepted**
      执行命令接受许可：
      ```bash
      flutter doctor --android-licenses
      ```
      按提示输入 `y` 确认所有许可
    - **问题2：Android SDK missing**
      在 Android Studio 中「Tools → SDK Manager」，下载对应 SDK 版本（建议 Android 11 (API 30)，兼容性好）
    - **问题3：Connected device not found**
      连接安卓手机（开启开发者模式、USB 调试），或启动安卓模拟器

## 七、 步骤6：创建并运行第一个 Flutter 项目
1.  打开 Android Studio，点击「New Flutter Project」
2.  选择「Flutter Application」→「Next」
3.  填写项目信息：
    - Project name：`my_first_flutter`（小写字母+下划线）
    - Flutter SDK path：选择你的 Flutter 解压路径
    - Project location：选择无中文无空格的目录
4.  点击「Finish」，等待项目初始化
5.  运行项目：
    - 连接安卓设备或启动模拟器
    - 点击工具栏「Run」按钮（绿色三角形），或快捷键 `Shift+F10`
6.  成功标志：设备/模拟器上显示 Flutter 默认计数器页面，支持热重载（修改代码后按 `Ctrl+S` 自动刷新）

## 八、 常见问题排查
1.  **Gradle 同步失败**
    - 确认 `gradle-7.0.2` 路径正确，且 Android Studio 已配置使用本地 Gradle
    - 检查项目 `android/build.gradle` 中 AGP 版本为 `7.0.4`（与 Gradle 7.0.2 匹配）
2.  **Dart 插件未生效**
    - 重启 Android Studio，或在「File → Invalidate Caches... → Invalidate and Restart」
3.  **Flutter 命令找不到**
    - 重新检查环境变量是否配置正确，重启终端/命令提示符

需要我给你整理一份**flutter doctor常见报错的修复清单**吗？

上一篇：ESP各个型号和常见模组

下一篇：单片机常见名称总结