Windows系统中Flutter与IntelliJIDEA的环境配置指南

最近开始深入学习 Flutter，首要任务就是搭建开发环境。在网上查阅了许多关于在 Windows 上配置 Flutter 环境的资料，大多数内容都基于官方文档，但阅读体验不如直接查看官方文档。本文旨在分享个人的实际配置经验，希望能帮助到同样在探索 Flutter 的开发者。

官方英文文档链接：Get Started: Install on Windows

官方中文文档链接：Get Started: Install on Windows

虽然网上的教程很多，但实际操作中可能会遇到各种问题。以下是经过实践验证的配置步骤，确保即使不完全遵循网络上的指导也能顺利完成配置。

• Flutter SDK：建议从官方网站下载最新版本的 Flutter SDK，下载后解压至自定义位置，并确保将 bin 目录添加到系统的 PATH 环境变量中。


• IDE 选择：推荐使用 Android Studio 或 IntelliJ IDEA。对于 Flutter 开发来说，Android Studio 是更优的选择，因为它自带了许多辅助工具。


• Dart 插件安装：无论选择哪种 IDE，都需要安装 Dart 插件以支持代码编辑和调试功能。


• Flutter 插件安装：同理，安装 Flutter 插件能够增强 IDE 对 Flutter 项目的管理和构建能力。

Flutter SDK 安装

首先从 Flutter 官方网站下载适用于 Windows 的 SDK 压缩包，解压到任意非受限路径，例如 C:\flutter。接下来，需要将 C:\flutter\bin 添加到系统的 PATH 环境变量中，以便可以在任何地方通过命令行调用 Flutter 命令。

注意：避免将 Flutter 安装在需要管理员权限的目录下，比如 C:\Program Files。

Flutter 环境测试

为了验证 Flutter 是否正确安装，可以通过命令行运行 flutter doctor 命令。此命令会检查你的开发环境并报告任何潜在的问题。在中国大陆地区，可能需要配置镜像源以加快依赖项的下载速度。具体操作是在命令行中依次输入以下命令：

• set PUB_HOSTED_URL=https://pub.flutter-io.cn


• set FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn

之后再次运行 flutter doctor，应该可以看到所有组件均已正确安装。

Android SDK 安装与配置

如果使用 IntelliJ IDEA 而不是 Android Studio，可能需要手动安装 Android SDK。可以通过访问 Android 官方网站下载 Command Line Tools，解压后将其放置于合适的目录下，例如 F:\Android\sdk\cmdline-tools\latest。

使用命令行工具 sdkmanager 可以安装所需的 Android 平台和工具。例如，安装 Android 10（API Level 29）及相关构建工具的命令为：

sdkmanager "platform-tools" "platforms;android-29" "build-tools;28.0.3"

安装过程中可能需要接受许可协议，按提示输入 y 即可。

环境变量配置

为了让系统识别 Android SDK，需要在系统环境变量中设置 ANDROID_HOME 指向 SDK 的根目录，并在 PATH 中添加 %ANDROID_HOME%\tools、%ANDROID_HOME%\platform-tools 和 %ANDROID_HOME%\build-tools。

IDE 插件配置

在 IntelliJ IDEA 中，通过插件市场搜索并安装 Dart 和 Flutter 插件。如果插件市场不可访问，可以从 JetBrains 插件仓库手动下载 ZIP 包，解压后将插件文件夹复制到 IDE 的插件目录下。

完成上述步骤后，重启 IDE 并创建一个新的 Flutter 项目，配置好 Flutter SDK 和 Dart SDK 的路径，即可开始编写代码。

初次运行项目前，还需创建一个虚拟设备（AVD），用于模拟不同的 Android 设备。在 IDE 的设置中选择 Android SDK 管理器，下载相应的系统镜像，然后创建 AVD。

至此，Windows 下 Flutter + IntelliJ IDEA 的开发环境已配置完成，你可以开始你的 Flutter 应用开发之旅了。