鸿蒙Flutter实战：Windows环境搭建踩坑指南
欢迎大家加入开源鸿蒙跨平台开发者专区
1. 前期准备：明确环境依赖
在开始搭建前，先确认Windows系统满足基础要求：
- 系统版本：Windows 10/11 64位（推荐专业版/企业版）
- 磁盘空间：至少预留10GB以上（包含SDK、DevEco Studio、依赖工具）
- 权限：以管理员身份执行后续命令（避免权限不足导致的配置失效）
2. 下载Flutter SDK并配置环境变量
2.1 克隆指定分支的Flutter SDK
鸿蒙适配的Flutter SDK需从AtomGit下载，优先选择稳定的oh-3.35.7-dev分支：
bash
# 建议将SDK克隆到非中文、无空格路径（如D:\flutter_oh），避免后续编译报错
git clone -b oh-3.35.7-dev https://gitcode.com/openharmony-tpc/flutter_flutter.git D:\flutter_oh2.2 配置用户环境变量（核心步骤）
鸿蒙Flutter开发依赖Java、DevEco SDK、ohpm等工具，需手动配置用户环境变量（优先用户变量，而非系统变量，避免重启系统）：
| 变量名 | 变量值（示例） | 说明 |
|---|---|---|
FLUTTER_STORAGE_BASE_URL |
https://storage.flutter-io.cn |
Flutter SDK镜像（加速下载） |
PUB_HOSTED_URL |
https://pub.flutter-io.cn |
Flutter Pub镜像（加速依赖安装） |
DEVECO_SDK_HOME |
C:\Program Files\Huawei\DevEco Studio\sdk |
DevEco SDK根目录（需先安装DevEco Studio） |
JAVA_HOME |
C:\Program Files\Huawei\DevEco Studio\jbr |
DevEco内置JDK（无需单独安装Java，避免版本冲突） |
FLUTTER_HOME |
D:\flutter_oh |
鸿蒙Flutter SDK根目录（克隆/解压路径） |
踩坑点2 ：JAVA_HOME必须指向DevEco Studio内置的JBR（jdk17），若单独安装其他版本Java，会导致Flutter检测到不兼容的JDK版本。
2.3 配置PATH环境变量
编辑用户变量中的PATH，添加以下路径（按顺序添加，避免工具冲突）：
bash
# Flutter核心命令
%FLUTTER_HOME%\bin
# DevEco工具链（ohpm/hvigor/node）
C:\Program Files\Huawei\DevEco Studio\tools\ohpm\bin
C:\Program Files\Huawei\DevEco Studio\tools\hvigor\bin
C:\Program Files\Huawei\DevEco Studio\tools\node
# Java命令
%JAVA_HOME%\bin踩坑点3：PATH中若存在其他版本的Flutter/Node/Java路径，需移到鸿蒙相关路径之后，避免优先调用非适配版本。
3. 验证环境配置（关键检查步骤）
配置完成后，重启命令行工具（CMD/PowerShell）（环境变量需重启生效），依次执行以下命令验证：
3.1 基础工具版本检查
bash
# 检查Java版本（需显示jdk17，对应DevEco内置版本）
java -version
# 检查Node版本（DevEco内置版本，一般为16+）
node -v
# 检查ohpm版本（鸿蒙包管理工具）
ohpm -v
# 检查hvigor版本（鸿蒙构建工具）
hvigor -v
# 检查Flutter版本（需显示oh-3.35.7-dev分支）
flutter --version踩坑点4：若提示"命令不存在"，大概率是PATH路径配置错误，或未重启命令行；若版本不符，需检查环境变量是否指向正确路径。
3.2 环境完整性检查
执行Flutter官方检查命令，排查所有依赖问题：
bash
flutter doctor理想输出：所有检查项均为绿色对勾（✓）；若出现红色叉号（✗），按提示修复：
- 若提示"Android license status unknown"：执行
flutter doctor --android-licenses并全部同意； - 若提示"DevEco SDK not found"：检查
DEVECO_SDK_HOME是否配置正确； - 若提示"Flutter SDK not configured"：检查
FLUTTER_HOME和PATH中的Flutter路径。
4. 补充踩坑点与解决方案
| 问题现象 | 原因 | 解决方案 |
|---|---|---|
flutter doctor 检测不到DevEco Studio |
DevEco SDK路径配置错误，或未安装DevEco Studio | 1. 安装最新版DevEco Studio；2. 确认DEVECO_SDK_HOME指向SDK根目录（非bin目录） |
| 克隆Flutter仓库时提示"SSL证书错误" | Windows Git SSL配置问题 | 执行git config --global http.sslVerify false（临时关闭SSL验证，仅用于国内镜像） |
| ohpm安装依赖时超时 | ohpm镜像未配置 | 在DevEco Studio中配置ohpm镜像：设置→构建、执行、部署→ohpm→镜像源，添加https://repo.huaweicloud.com/repository/ohpm/ |
| 环境变量配置后重启命令行仍不生效 | 配置了系统变量而非用户变量，或路径包含中文/空格 | 1. 重新配置到用户变量；2. 将Flutter/DevEco路径移到无中文、无空格的目录（如D:\dev\flutter_oh） |
总结
- 鸿蒙Flutter SDK需下载
oh-3.35.7-dev分支，且路径需避免中文/空格，否则易触发编译或命令执行错误； - 环境变量优先配置用户变量 ，核心需配置
FLUTTER_HOME、JAVA_HOME（DevEco内置JDK）、DEVECO_SDK_HOME，并将相关工具路径加入PATH； - 配置后需重启命令行，通过
flutter doctor和基础工具版本命令验证，按提示修复红色叉号问题，是环境搭建成功的关键。