一、前置准备：明确依赖与下载工具

1. 必备依赖清单

• 操作系统：Windows 10/11（64 位）

• 基础工具：

  • Android Studio：提供 Android SDK、模拟器及开发工具支持

  • Flutter SDK：核心开发框架，必装

  • Git：可选，用于版本控制，部分 Flutter 功能依赖

• 硬件要求：至少 4GB 内存，预留 10GB 以上磁盘空间（存储 SDK、依赖、模拟器镜像）

2. 工具下载地址

• Flutter SDK：官网下载页，选择稳定版（Stable channel）

• Android Studio：官网下载页，默认最新版即可

• Git：官网下载页，可选，按默认选项安装

二、第一步：安装 Flutter SDK

1. 解压 Flutter SDK

1. 下载 Flutter SDK 压缩包（如 flutter_windows_3.16.9-stable.zip）；

2. 选择非中文、无空格的目录解压（关键！避免路径识别错误），推荐路径：D:\Develop\Flutter\flutter（解压后文件夹含 bin、packages 等子目录）；

3. 牢记该路径，后续配置环境变量需用到。

2. 配置 Flutter 环境变量

目的：让 Windows 命令行全局识别 flutter 命令，无需每次进入 SDK 目录执行。

1. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」；

2. 在「系统变量」栏找到「Path」，点击「编辑」；

3. 点击「新建」，粘贴 Flutter SDK 的 bin 目录路径（示例：D:\Develop\Flutter\flutter\bin）；

4. 连续点击「确定」保存所有窗口，不遗漏；

5. 验证配置：打开新的命令行窗口（旧窗口需重启），输入 flutter --version，若输出 Flutter 及 Dart 版本号（如 Flutter 3.16.9），则配置成功。

三、第二步：安装 Android Studio

1. 安装 Android Studio

1. 运行安装包（如 android-studio-2023.1.1.26-windows.exe）；

2. 点击「Next」，默认勾选「Android Studio」和「Android Virtual Device」（模拟器支持，必选）；

3. 选择非中文、无空格安装路径（推荐：D:\Develop\AndroidStudio）；

4. 等待安装完成（需下载基础组件，耗时看网络）；

5. 首次启动配置：

   1. 提示「Import Android Studio Settings」时，选「Do not import settings」→「OK」；

   2. 进入欢迎界面后，点击「Next」→ 选「Standard」（标准安装）→「Next」；

   3. 选择 UI 主题，点击「Next」；

   4. 确认 SDK 安装路径（默认示例：C:\Users\你的用户名\AppData\Local\Android\Sdk），牢记此路径；

   5. 点击「Finish」，等待 SDK 基础组件下载（约 5-10 分钟）。

2. 安装 Android SDK Command-line Tools（解决 cmdline-tools missing 问题）

1. 打开 Android Studio，顶部菜单栏「Tools」→「SDK Manager」（或快捷键 Ctrl+Alt+S，搜索 SDK Manager）；

2. 切换到「SDK Tools」标签，勾选「Show Package Details」（显示详细组件）；

3. 展开「Android SDK Command-line Tools (latest)」，勾选该组件（版本自动匹配最新）；

4. 确保「Android SDK Build-Tools」「Android Emulator」「Android SDK Platform-Tools」已勾选（默认已选，未选则补勾）；

5. 点击「Apply」→「OK」，等待安装完成（约 2-5 分钟），完成后关闭 SDK Manager。

3. 配置 Android SDK 环境变量

目的：让 Flutter 自动识别 Android SDK 路径，避免手动配置。

1. 打开「环境变量」（同 Flutter 环境变量入口）；

2. 「系统变量」栏点击「新建」，添加变量：

   1. 变量名：ANDROID_HOME

   2. 变量值：Android SDK 安装路径（即上文牢记的路径）

3. 编辑「系统变量」中的「Path」，添加两个路径：

   1. %ANDROID_HOME%\platform-tools

   2. %ANDROID_HOME%\tools

4. 点击「确定」保存，重启命令行窗口生效。

注意:这里环境变量配置后,之前已经启动的应用(如git,Android Studio)需要重新启动才会识别到

四、第三步：配置 Flutter 国内镜像

1. 配置原因

Flutter 默认依赖国外站点（如 pub.dev、storage.googleapis.com），国内网络易卡顿超时，导致初始化失败、依赖下载卡住。

2. 永久配置镜像

1. 打开「环境变量」（右键此电脑→属性→高级系统设置→环境变量）；

2. 在「用户变量」栏点击「新建」，依次添加两个变量（名称和值完全一致，无空格）：

   1. 变量名：PUB_HOSTED_URL，变量值：https://pub.flutter-io.cn

   2. 变量名：FLUTTER_STORAGE_BASE_URL，变量值：https://storage.flutter-io.cn

3. 点击「确定」保存，重启所有命令行窗口和 Android Studio（确保生效）。

3. 验证镜像配置

1. 打开新的命令行窗口；

2. 输入以下两条命令，输出与配置的镜像地址一致即成功： echo %PUB_HOSTED_URL% echo %FLUTTER_STORAGE_BASE_URL%

五、第四步：初始化 Flutter 并解决依赖问题

1. 首次运行 Flutter 初始化

1. 打开命令行窗口，输入 flutter 命令（首次运行自动执行初始化）；

2. 等待完成，显示「Got dependencies.」即依赖下载成功：

   1. 配置镜像后耗时约 1-3 分钟；

   2. 若卡住，按 Ctrl+C 终止，重新执行 flutter（支持断点续传，已下载文件不重复）。

2. 接受 Android SDK 许可协议（解决 license unknown 问题）

1. 命令行输入命令： flutter doctor --android-licenses

2. 弹出许可协议确认时，每次输入 y 并回车（约 5-8 次）；

3. 显示「All SDK package licenses accepted」即完成。

六、第五步：用 flutter doctor 检查并修复环境

1. 执行环境检查

命令行输入 flutter doctor，自动检测 Flutter 开发所需所有环境（Flutter、Windows、Android 工具链等）。

2. 常见问题及解决方案

• 问题：[×] Android toolchain - develop for Android devices → cmdline-tools component is missing 解决方案：回到第三步 2，重新安装 Android SDK Command-line Tools (latest)

• 问题：Android license status unknown 解决方案：重新执行 flutter doctor --android-licenses，确保所有确认都输入 y

• 问题：Unable to connect to storage.googleapis.com 解决方案：检查镜像配置是否生效，重启命令行窗口后重新执行 flutter doctor

• 问题：HTTP error when checking GitHub 解决方案：网络临时问题，不影响基础开发；需访问 GitHub 时切换手机热点或配置加速

• 问题：[×] Visual Studio - develop for Windows 解决方案：需开发 Windows 桌面应用则安装 Visual Studio 2022，勾选「桌面开发使用 C++」；无需可忽略

3. 目标状态

执行 flutter doctor 后，核心组件显示「✓」即可（GitHub 相关错误可忽略），示例如下：

[✓] Flutter (Channel stable, 3.16.9, on Microsoft Windows [版本 10.0.19045.3930], locale zh-CN) 
[✓] Windows Version (Installed version of Windows is version 10 or higher) 
[✓] Android toolchain - develop for Android devices (Android SDK version 34.0.0)
[✓] Chrome - develop for the web 
[✓] Visual Studio - develop for Windows (Visual Studio Community 2022 17.9.6)
[✓] Android Studio (version 2023.1)
[✓] Connected device (3 available) 
[✓] Network resources

七、第六步：创建第一个 Flutter 项目

1. 新建项目

1. 打开 Android Studio，点击「Start a new Flutter project」；

2. 选择「Flutter Application」→「Next」；

3. 填写项目信息：

   1. Project name：项目名（如 first_flutter_app，仅字母、数字、下划线，首字母小写）；

   2. Flutter SDK path：选择 Flutter SDK 解压路径；

   3. Project location：项目保存路径（非中文、无空格）；

   4. Description：项目描述（可选）。

4. 点击「Next」→ 勾选「AndroidX artifacts」→「Next」；

5. 选择项目图标（默认即可）→「Finish」；

6. 等待项目初始化（首次下载依赖约 1-2 分钟，镜像生效后更快）。

2. 运行项目（Android 模拟器为例）

（1）启动模拟器

1. 点击 Android Studio 顶部「Device Manager」（手机+齿轮图标）；

2. 点击「Create device」→ 选择设备（如 Pixel 7）→「Next」；

3. 选择 API 33 或 34 系统镜像（点击 Download 下载，约 1-3 分钟）→「Next」；

4. 点击「Finish」创建模拟器，再点击右侧「Play」按钮启动（首次启动约 1 分钟）。

（2）运行项目

1. 确保顶部工具栏已选中创建的模拟器（如 Pixel 7 - API 33）；

2. 点击顶部绿色三角形「Run」按钮，或按快捷键 Shift+F10。

（3）验证结果

模拟器中显示 Flutter 默认计数器应用（含「0」和「+」按钮），说明环境完全就绪，可正常开发。