本教程完全基于实际操作历程整理，适配 Win11 系统，从环境准备、软件安装到 Flutter 多端（Web、Windows 桌面、Android 手机）运行，全程避开常见报错，新手可直接跟着操作，高效完成配置。

一、前期准备（必做）

1. 硬件与系统要求

• 系统：Windows 11（确保系统更新至最新，避免兼容性问题）

• 磁盘：预留至少 20GB 空间（建议将 Flutter SDK、项目、Visual Studio 部分组件安装在非 C 盘，减少 C 盘占用）

• 网络：稳定网络（用于下载软件、依赖包，建议后续配置国内镜像，提升下载速度）

• 手机：安卓手机（用于测试 Android 端，后续需开启开发者模式）

2. 提前下载所需安装包（可选，也可安装时在线下载）

• Android Studio：官网下载（https://developer.android.com/studio），选择 Windows 版

• Flutter SDK：官网下载（https://flutter.dev/docs/get-started/install/windows），解压至非 C 盘（如 D:\flutter）

• Visual Studio Community 2022：官网下载（https://visualstudio.microsoft.com/zh-hans/free-developer-offers/），用于 Flutter Windows 桌面版编译

二、安装 Android Studio（核心步骤）

步骤 1：运行安装包，选择安装路径

双击 Android Studio 安装包，点击“Next”，建议将安装路径修改为非 C 盘（如 D:\Program Files\Android\Android Studio），避免占用 C 盘空间，后续步骤默认下一步即可。

步骤 2：配置 SDK（关键）

• 安装完成后，首次启动 Android Studio，会提示“没有 SDK”，点击“Cancel”进入主界面。

• 进入主界面后，点击“More Actions → SDK Manager”，在“SDK Platforms”中勾选至少一个 Android 版本（建议勾选 Android 13/14，兼容大部分手机）。

• 切换到“SDK Tools”，勾选“Android SDK Build-Tools”“Android SDK Platform-Tools”，后续配置 Flutter 时还需补充“Android SDK Command-line Tools (latest)”，点击“Apply”下载安装，等待完成后重启 Android Studio。

步骤 3：配置环境变量（可选，方便后续终端操作）

右键“此电脑 → 属性 → 高级系统设置 → 环境变量”，在“系统变量”中找到“Path”，添加以下路径（根据你的安装路径修改）：

• D:\Program Files\Android\Android Studio\bin

• D:\Android\Sdk\platform-tools（SDK 安装路径下的 platform-tools 文件夹）

三、安装并配置 Flutter SDK

步骤 1：解压 SDK 并配置环境变量

• 将下载的 Flutter SDK 压缩包解压至非 C 盘（如 D:\flutter），确保解压后文件夹内有“bin”目录。

• 再次进入“环境变量”，在“系统变量”的“Path”中添加：D:\flutter\bin（根据你的解压路径修改）。

• 配置完成后，打开新的终端（CMD 或 PowerShell），输入 flutter --version，若能显示 Flutter 版本，说明环境变量配置成功。

步骤 2：检查 Flutter 环境（关键，提前排查问题）

在终端输入 flutter doctor，会显示当前环境的检测结果，重点关注以下几项，后续逐步修复：

• Flutter：显示版本，无报错即可。

• Android toolchain：首次检测会提示缺少“Command-line Tools”和许可证，后续补充。

• Chrome：若已安装 Chrome/Edge，会显示正常，用于 Web 端测试。

• Visual Studio：首次检测会报错，后续安装并配置后可修复，用于 Windows 桌面版。

四、配置 Flutter Web 端（最简单，优先测试）

Web 端无需额外安装依赖，直接在终端执行以下命令，即可启动 Web 版测试：

1. 进入 Flutter 项目目录（若没有项目，先执行 flutter create flutter_demo 创建默认计数器项目，建议放在非 C 盘，如 D:\flutter_projects\flutter_demo）。

2. 执行 flutter run -d edge（或 flutter run -d chrome），首次运行会下载 Web 依赖，等待 1-2 分钟，会自动打开浏览器，显示默认计数器页面，点击右下角“+”按钮，数字可正常增加，说明 Web 端配置成功。

3. 停止运行：在终端按 q 键即可。

五、配置 Flutter Windows 桌面版（需安装 Visual Studio）

步骤 1：安装 Visual Studio 2022（核心依赖）

• 运行 Visual Studio 安装包，勾选“使用 C++ 的桌面开发”（Flutter 桌面版唯一必需的工作负载），其他负载无需勾选，减少安装体积。

• 点击“更改”，将安装路径修改为非 C 盘（如 D:\Program Files\Microsoft Visual Studio\18\Community），同时将“共享组件、工具和 SDK”“下载缓存”也修改至 D 盘，最大程度减少 C 盘占用。

• 点击“安装”，等待 10-20 分钟（取决于网络），安装过程中若弹出登录异常弹窗，直接点击“继续”，无需登录，不影响安装。

• 安装完成后，重启 Android Studio。

步骤 2：验证环境并运行 Windows 桌面版

1. 重启 Android Studio 后，打开终端，输入 flutter doctor，确认“Visual Studio - develop for Windows”显示为 ✅，说明环境就绪。

2. 进入 Flutter 项目目录，执行 flutter run -d windows，首次运行会编译 Windows 端代码，等待 1-2 分钟，会自动弹出 Windows 桌面窗口，显示计数器页面，交互正常，说明 Windows 桌面版配置成功。

六、配置 Flutter Android 手机版（需补全 Android 环境）

步骤 1：补全 Android 工具链（修复 flutter doctor 警告）

1. 打开 Android Studio → “Settings → Languages & Frameworks → Android SDK → SDK Tools”，勾选“Android SDK Command-line Tools (latest)”，点击“Apply”安装。

2. 安装完成后，在终端执行 flutter doctor --android-licenses，一路按 y 确认，接受所有许可证，完成后再次执行 flutter doctor，Android toolchain 会显示为 ✅。

步骤 2：手机开启开发者模式并连接电脑

• 安卓手机打开“设置 → 关于手机”，连续点击“版本号”5-7 次，开启“开发者模式”。

• 回到设置，找到“开发者选项”，开启“USB 调试”，用 USB 数据线将手机连接至电脑。

• 手机弹出“允许 USB 调试？”，选择“允许”；在终端输入 flutter devices，若能看到自己的手机型号（如 V2408A），说明手机已被识别。

步骤 3：解决 Gradle 下载慢/超时（关键避坑）

首次运行 Android 版时，容易因 Gradle 下载国外依赖超时，需配置国内镜像：

1. 找到项目目录下的 android/gradle/wrapper/gradle-wrapper.properties 文件，打开后将 distributionUrl 替换为阿里云镜像：

原内容：distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-bin.zip 替换为：distributionUrl=https\://mirrors.aliyun.com/gradle/gradle-7.5-bin.zip

1. 找到项目目录下的 android/build.gradle 文件，在 repositories 块中添加阿里云镜像（具体修改如下）： `buildscript { repositories { // 新增阿里云镜像 maven { url 'https://maven.aliyun.com/repository/google' } maven { url 'https://maven.aliyun.com/repository/public' } maven { url 'https://maven.aliyun.com/repository/gradle-plugin' } google() mavenCentral() } }

allprojects { repositories { // 新增阿里云镜像 maven { url 'https://maven.aliyun.com/repository/google' } maven { url 'https://maven.aliyun.com/repository/public' } google() mavenCentral() } }`

步骤 4：运行 Android 手机版

1. 保存上述两个文件的修改，在终端执行 flutter run（或点击 Android Studio 右上角“运行”按钮，选择自己的手机）。

2. 首次运行会下载 Android 依赖，等待 3-5 分钟（配置镜像后速度会显著提升），下载完成后会自动将 App 安装到手机并启动。

3. 手机上会出现“flutter_demo”应用，界面与 Web 版、桌面版完全一致，点击“+”按钮可正常交互，说明 Android 手机版配置成功。

4. 停止运行：在终端按 q 键即可。

七、常见问题与避坑指南（重点，基于实际操作遇到的问题整理）

1. Visual Studio 安装默认到 C 盘

解决方案：安装时点击“更改”，将“产品路径”“共享组件路径”“下载缓存”均修改至非 C 盘，核心工具链虽仍会占用少量 C 盘（约 493MB），但已最小化占用。

2. Gradle 下载慢/超时、卡着不动

解决方案：配置阿里云镜像（参考第六部分步骤 3）；若仍慢，切换至手机热点；首次构建慢是正常现象，耐心等待 5-10 分钟，不要轻易取消，取消后需重新下载。

3. 手机连接后，flutter devices 识别不到

解决方案：确认手机“USB 调试”已开启；更换 USB 数据线（部分数据线仅支持充电，不支持数据传输）；检查电脑是否安装手机驱动（可通过手机品牌官网下载）。

4. 停止构建后，下次重启是否需要重新下载

不需要，已下载的依赖会缓存到本地，下次重启会直接复用，速度会比第一次快很多。

5. Android Studio 启动报错、Flutter 命令无法识别

解决方案：检查环境变量配置是否正确（Flutter SDK 的 bin 目录、Android SDK 的 platform-tools 目录是否添加到 Path）；重启终端或电脑，确保环境变量生效。

八、总结

按照本教程操作，可完成 Win11 系统下 Android Studio + Flutter 的完整配置，实现 Web、Windows 桌面、Android 手机三端运行，全程贴合实际操作，避开了下载慢、识别不到设备、Gradle 超时等常见坑。

配置完成后，可修改 Flutter 项目代码（如修改默认计数器页面为个人 IP 风格），体验“一套代码，多端运行”的优势，后续可学习打包成 .exe 文件（桌面版）、APK 文件（手机版），实现应用分发。