开源鸿蒙跨平台训练营 Day1 关于开源鸿蒙-Flutter编译开发HarmonyOS的环境搭建问题：Flutter 分支版本不支持 Windows 模拟器和Node.js 版本过高解决方案

一、问题定位

1. 检查 Flutter 版本
   执行命令：

   flutter --version
   

   • 若 channel 为 dev 或 master，或版本号低于 3.10，则不支持 Windows 模拟器。
2. 检查 Node.js 版本
   执行命令：

   node -v
   

   • 若版本为 20.x 或更高（如 v20.1.0），需降级至 16.x 或 18.x。

二、分步解决

问题1：Node.js 版本过高

1. 安装 nvm-windows

   • 下载 nvm-setup.exe
   • 安装路径避免中文/空格（如 D:\nvm）
   • 设置 Node.js 符号链接路径（如 D:\nodejs）

2. 切换 Node.js 版本

   # 查看可用版本
   nvm list available
   # 安装 16.20.2（推荐）
   nvm install 16.20.2
   # 切换版本
   nvm use 16.20.2
   # 验证
   node -v  # 应输出 v16.20.2
   

问题2：Flutter 分支不支持 Windows 模拟器

1. 切换至稳定分支并升级

   flutter channel stable
   flutter upgrade  # 确保版本 ≥3.10
   

   • 网络优化（可选）：

     set PUB_HOSTED_URL=https://pub.flutter-io.cn
     set FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
     

2. 检查环境依赖

   flutter doctor -v
   

   • 缺失依赖处理：
     • 安装 Visual Studio 2022，勾选 C++ 桌面开发 和 Windows SDK
     • 配置 HarmonyOS SDK 路径至环境变量

3. 验证插件兼容性

   • 在 pubspec.yaml 中确认 flutter_openharmony 版本与 Flutter 匹配
   • 更新依赖：

     flutter pub get
     

三、清理与构建

# 清理缓存
flutter clean
# 重新编译运行
flutter run -d windows

• 终端乱码修复：

  chcp 65001  # PowerShell 中执行
  

四、结果验证

• Windows 模拟器正常启动且无报错 → 成功
• 若仍有报错 → 检查日志中的 version 或 compatible 关键词

关键总结

1. Node.js：使用 nvm-windows 管理，锁定 16.x 或 18.x
2. Flutter：必须切换至 stable 分支（≥3.10）
3. 缓存：环境变更后执行 flutter clean

欢迎加入开源鸿蒙跨平台社区：https://openharmonycrossplatform.csdn.net