目前 Flutter 对鸿蒙的支持主要由 OpenHarmony TPC 维护，使用的是 Flutter 的特定分支版本，而非 Google 官方主干。

---

Windows 端 Flutter 鸿蒙开发环境搭建指南

更新时间：2025年
适用系统：Windows 10 / 11
核心目标：搭建一套既能开发 Android/iOS，又能开发 HarmonyOS Next 应用的 Flutter 环境。

---

第一阶段：准备工作与核心工具安装

在开始之前，请确保你的电脑满足以下条件：

• 磁盘空间：建议预留 30GB 以上空间。
• 路径规范：严禁使用包含中文或空格的安装路径（例如不要安装在 Program Files，建议直接在 D 盘根目录建立 D:\DevEnv）。

1. 安装 DevEco Studio (鸿蒙 IDE)

这是鸿蒙开发的必须工具，包含了 HarmonyOS SDK、Node.js、Ohpm 等编译链。

1. 下载：访问 HarmonyOS 开发者官网 下载 DevEco Studio NEXT 版本（建议 Release ）。
2. 安装：
   • 安装过程中，记录下安装路径（例如：D:\Huawei\DevEco Studio）。
   • 首次启动时，根据向导下载 SDK。
   • 关键步骤：记录 SDK 的下载路径（默认为 C:\Users\用户名\AppData\Local\Huawei\Sdk，建议修改为 D:\Huawei\Sdk 以防C盘爆满）。

2. 安装 Git

如果尚未安装，请访问 Git 官网 下载并安装。

---

第二阶段：获取鸿蒙版 Flutter SDK

由于官方 Flutter 尚未合并鸿蒙支持，必须使用 OpenHarmony SIG 维护的 Fork 版本。

1. 创建目录：
   在非系统盘创建一个目录存放 SDK，例如 D:\FlutterSDK。

2. 克隆代码：
   打开 CMD 或 PowerShell，进入该目录并执行：

   cd /d D:\FlutterSDK
   git clone https://gitee.com/openharmony-tpc/flutter_flutter.git
   

   注意：这将创建一个名为 flutter_flutter 的文件夹。

3. 切换分支：
   目前推荐使用 dev 分支（更新最快，适配较好）或查看仓库说明选择特定版本（如 3.22 适配版）。

   cd flutter_flutter
   git checkout -b dev origin/dev
   

4. 更新依赖：
   执行以下命令预下载 Dart SDK 和基础依赖：

   bin\flutter --version
   

   如果下载速度慢，请先进行下方的“配置环境变量”步骤中的镜像配置，再回来执行此步。

---

第三阶段：配置系统环境变量（最关键步骤）

Windows 环境变量配置错误是 90% 失败的原因。请按 Win + S 搜索“编辑系统环境变量”，点击“环境变量”。

1. 新建/修改用户变量 (User Variables)

在“用户变量”区域，新建或修改以下变量：

变量名	变量值 (示例路径，请根据实际情况修改)	说明
PUB_HOSTED_URL	https://pub.flutter-io.cn	国内镜像，防卡顿
FLUTTER_STORAGE_BASE_URL	https://storage.flutter-io.cn	国内镜像
DEVECO_SDK_HOME	D:\Huawei\Sdk	必须指向你的鸿蒙 SDK 根目录
JAVA_HOME	D:\Huawei\DevEco Studio\jbr	指向 DevEco 内置的 JDK (无需单独装 Java)

2. 编辑 Path 变量

在“用户变量”中找到 Path，点击“编辑”，新建并将以下路径添加到列表顶部（注意顺序）：

1. Flutter BIN 目录：
   D:\FlutterSDK\flutter_flutter\bin
2. Ohpm (包管理器)：
   D:\Huawei\DevEco Studio\tools\ohpm\bin
3. Hvigor (构建工具)：
   D:\Huawei\DevEco Studio\tools\hvigor\bin
4. Node.js (DevEco内置)：
   D:\Huawei\DevEco Studio\tools\node
5. HDC (鸿蒙调试桥)：
   D:\Huawei\Sdk\openharmony\10\toolchains
   (注意：10 是版本号，路径中可能是 11 或 default，请去文件夹里确认 hdc.exe 在哪里)

---

第四阶段：验证环境

1. 重启电脑 或 重启终端（确保环境变量生效）。
2. 执行诊断命令：

   flutter doctor -v
   

   环境验证
   

   

检查项说明：

• ✅ Flutter (Channel dev…)：应显示 OpenHarmony 版本。
• ✅ HarmonyOS：这是关键项。如果出现 ✗，通常是因为 DEVECO_SDK_HOME 没配对，或者 hdc 没在 Path 里。
• ✅ OpenHarmony：显示已定位到 SDK。
• ! Android Studio：如果这里报错 Java 找不到，通常不影响鸿蒙开发，只要 HarmonyOS 那一项是勾选的即可。

---

第五阶段：创建并运行第一个鸿蒙 Flutter 项目

1. 创建项目

在终端执行：

flutter create --platforms ohos,android,ios my_harmony_app

• --platforms ohos：明确指定生成鸿蒙工程目录。
• 进入目录：cd my_harmony_app

2. 签名配置（真机调试必做，模拟器可跳过）

鸿蒙真机运行必须签名。

1. 使用 DevEco Studio 打开项目下的 ohos 文件夹。
2. 点击菜单 File -> Project Structure -> Project -> Signing Configs。
3. 勾选 Automatically generate signature（自动生成签名）。
4. 等待 Gradle/Hvigor 同步完成。

3. 运行项目

方式一：命令行运行
连接鸿蒙手机（开启开发者模式）或启动 DevEco 模拟器，执行：

flutter run -d <设备ID>

(使用 flutter devices 查看设备ID)

方式二：DevEco Studio 运行 (推荐)

1. 在 DevEco Studio 中打开 ohos 目录。

2. 点击顶部绿色的 “Run” 按钮。

3. APP 会被安装到手机上，但这只是原生壳。Flutter 代码的热重载（Hot Reload）仍需在 VS Code 或命令行终端连接。

   例示运行结果

---

常见问题与避坑指南

Q1: flutter doctor 找不到 HarmonyOS SDK？

• 解决：检查 DEVECO_SDK_HOME 变量是否指向了 SDK 的根目录（目录下应该有 openharmony 或 harmonyos 文件夹）。确保 DevEco Studio 已经下载了 API Version 11 或 12 的 SDK。

Q2: 编译时报错 hvigor ERROR: ...？

• 解决：通常是 Node.js 版本不匹配。请确保 Path 变量中优先使用的是 DevEco Studio 自带的 tools\node 路径，而不是你自己单独安装的 Node.js。

Q3: 无法下载 Gradle 或依赖库？

• 解决：在 ohos/build-profile.json5 或相关配置文件中，检查 npm 仓库地址，建议配置华为的镜像源。

Q4: 已经有官方 Flutter SDK 了怎么办？

• 解决：你可以使用 FVM (Flutter Version Management) 来管理多个版本，或者简单粗暴地在环境变量 Path 中，将鸿蒙版 Flutter 的 bin 路径移动到官方版 bin 路径的上方。当需要开发鸿蒙时，系统会优先识别上方的版本。

---

按照以上步骤，你应该可以在 Windows 上成功运行 Flutter 鸿蒙应用。如果在 git clone 仓库时速度过慢，建议尝试使用 SSH 方式或寻找国内 Gitee 的其他镜像源。