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 --version
JDK 17	支撑鸿蒙构建链路	java -version
DevEco Studio	提供 IDE、SDK Manager、签名和鸿蒙工具链	打开 IDE 检查 SDK
OpenHarmony SDK	鸿蒙应用构建和 API 依赖	DEVECO_SDK_HOME 指向 SDK
ohpm	鸿蒙包管理工具	ohpm -v
hvigor	鸿蒙构建工具	hvigor -v
node	ohpm/hvigor 依赖的运行环境	node -v

这些工具不需要全部手动散装。DevEco Studio 安装后通常会带一套 tools 目录，里面包含 ohpm、hvigor 和 node。关键是把它们正确加入环境变量。

安装 Git

Git 安装完成后，重新打开命令行窗口，执行：

git --version

如果命令找不到，说明安装时没有加入 PATH。可以把 Git 的 cmd 目录追加到系统环境变量，例如：

C:\Program Files\Git\cmd

后续下载 flutter_flutter 仓库、拉取插件依赖、查看版本提交都会用到 Git。Windows 下如果 flutter 命令闪退，官方 FAQ 中也提到可以检查 Git 环境变量。

安装 JDK 17

OpenHarmony Flutter 仓库的环境说明中明确要求 JDK 17。安装完成后配置：

JAVA_HOME=D:\DevTools\Java\jdk-17
PATH=%JAVA_HOME%\bin

验证：

java -version
javac -version

输出中看到 17 才算匹配。如果本机已有多个 JDK，优先检查 where java：

where java

它会列出当前命令行实际使用的 java 路径。很多构建失败不是因为没有安装 JDK，而是 PATH 中排在前面的仍然是旧版本。

安装 DevEco Studio 和 SDK

DevEco 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 的错误，可以在用户目录创建 .npmrc：

C:\Users\你的用户名\.npmrc

写入：

registry=https://repo.huaweicloud.com/repository/npm/
@ohos:registry=https://repo.harmonyos.com/npm/

保存后重新打开命令行，再执行：

ohpm -v
hvigor -v

安装结果验证

所有基础工具安装后，用这一组命令做验收：

git --version
java -version
javac -version
node -v
ohpm -v
hvigor -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。先查实际路径：

where java
where node
where ohpm
where hvigor
where flutter

这些命令输出的第一个路径才是当前命令行实际使用的路径。版本冲突时，不要只看安装目录，要看 where 的结果。
Flutter。先查实际路径：

where java
where node
where ohpm
where hvigor
where flutter

这些命令输出的第一个路径才是当前命令行实际使用的路径。版本冲突时，不要只看安装目录，要看 where 的结果。