02. Flutter鸿蒙开发环境准备安装DevEco Studio、Git、JDK和基础工具环境准备是 Flutter 鸿蒙开发里最容易踩坑的一步。普通 Flutter 项目主要依赖 Flutter SDK 和 Android/iOS 工具链而鸿蒙项目还需要 DevEco Studio 提供 OpenHarmony SDK、ohpm、hvigor 和 node。工具装错、路径没配、版本不匹配都会在后面的flutter doctor -v或flutter build hap中暴露。工具清单开始前先明确每个工具的作用工具作用验证命令Git下载 SDK、插件、三方库源码git --versionJDK 17支撑鸿蒙构建链路java -versionDevEco Studio提供 IDE、SDK Manager、签名和鸿蒙工具链打开 IDE 检查 SDKOpenHarmony SDK鸿蒙应用构建和 API 依赖DEVECO_SDK_HOME指向 SDKohpm鸿蒙包管理工具ohpm -vhvigor鸿蒙构建工具hvigor -vnodeohpm/hvigor 依赖的运行环境node -v这些工具不需要全部手动散装。DevEco Studio 安装后通常会带一套tools目录里面包含 ohpm、hvigor 和 node。关键是把它们正确加入环境变量。安装 GitGit 安装完成后重新打开命令行窗口执行git--version如果命令找不到说明安装时没有加入 PATH。可以把 Git 的cmd目录追加到系统环境变量例如C:\Program Files\Git\cmd后续下载flutter_flutter仓库、拉取插件依赖、查看版本提交都会用到 Git。Windows 下如果flutter命令闪退官方 FAQ 中也提到可以检查 Git 环境变量。安装 JDK 17OpenHarmony Flutter 仓库的环境说明中明确要求 JDK 17。安装完成后配置JAVA_HOMED:\DevTools\Java\jdk-17 PATH%JAVA_HOME%\bin验证java-versionjavac-version输出中看到17才算匹配。如果本机已有多个 JDK优先检查where javawherejava它会列出当前命令行实际使用的 java 路径。很多构建失败不是因为没有安装 JDK而是 PATH 中排在前面的仍然是旧版本。安装 DevEco Studio 和 SDKDevEco Studio 安装完成后进入 SDK Manager下载与当前 Flutter OpenHarmony SDK 匹配的 SDK。官方 README 中以 API 12、DevEco Studio 5.0 或 command-line-tools-5.0 为例说明环境依赖实际项目要以你使用的 SDK 分支和文档说明为准。安装路径要记录下来后面配置变量会用到D:\DevTools\DevEco Studio常见工具路径如下D:\DevTools\DevEco Studio\sdk D:\DevTools\DevEco Studio\tools\ohpm\bin D:\DevTools\DevEco Studio\tools\hvigor\bin D:\DevTools\DevEco Studio\tools\node配置 npm 源构建 hap 时如果出现 hvigor 依赖.npmrc的错误可以在用户目录创建.npmrcC:\Users\你的用户名\.npmrc写入registryhttps://repo.huaweicloud.com/repository/npm/ ohos:registryhttps://repo.harmonyos.com/npm/保存后重新打开命令行再执行ohpm-vhvigor-v安装结果验证所有基础工具安装后用这一组命令做验收git--versionjava-versionjavac-versionnode-vohpm-vhvigor-v如果其中任何一个命令失败先不要继续配置 Flutter SDK。基础工具没通后面的flutter doctor -v只会把问题包装成更长的错误信息。Windows 环境变量写法细节系统环境变量里不要写成一整段命令而是逐项添加。JAVA_HOME、TOOL_HOME、DEVECO_SDK_HOME属于变量名和值Path里放可执行文件所在目录。JAVA_HOME D:\DevTools\Java\jdk-17 TOOL_HOME D:\DevTools\DevEco Studio DEVECO_SDK_HOME %TOOL_HOME%\sdk Path 追加 %JAVA_HOME%\bin %TOOL_HOME%\tools\ohpm\bin %TOOL_HOME%\tools\hvigor\bin %TOOL_HOME%\tools\node修改后重新打开命令行老窗口不会自动刷新。遇到“明明配置了但命令找不到”先关掉当前终端再开一个。工具版本冲突处理同一台电脑可能安装过多个 node、多个 JDK、多个 Flutter。先查实际路径wherejavawherenodewhere ohpm where hvigor where flutter这些命令输出的第一个路径才是当前命令行实际使用的路径。版本冲突时不要只看安装目录要看where的结果。Flutter。先查实际路径wherejavawherenodewhere ohpm where hvigor where flutter这些命令输出的第一个路径才是当前命令行实际使用的路径。版本冲突时不要只看安装目录要看where的结果。