拷贝或克隆其他 Flutter OH 项目到本地后无法运行

从同事电脑拷贝目录，或从 Git 克隆 Flutter OpenHarmony 工程后，执行 flutter pub get、flutter run 或 flutter build hap 时出现 依赖解析失败、编译报错、ohos 模块找不到、运行闪退 等，而在原环境正常。

类型	说明
Flutter / Dart 版本不一致	`pubspec.yaml` 里 `environment.sdk` 或 `flutter` 约束与本地工具链不匹配。
锁定文件与环境绑定	`pubspec.lock` 在另一台机器/另一版 Flutter 上生成，直接沿用易导致解析冲突。
本地构建产物与缓存	`build/`、`dart_tool/`、`ohos/oh_modules` 等来自旧路径或旧 SDK，未清理会继续报错。
鸿蒙侧依赖未拉全	仅执行了 Dart 侧 `pub get`，未在 `ohos` 下用 ohpm 安装，或 Node/ohpm 版本不符。
本机独有配置未入库	如签名、SDK 路径等若在 `.gitignore` 中，克隆后需按文档自行补全。

下面按推荐顺序排查。

打开项目根目录 pubspec.yaml，查看：

yaml 复制代码

environment:
  sdk: ^3.x.x   # 示例，以项目为准

dependencies:
  flutter:
    sdk: flutter

在终端执行：

sh 复制代码

flutter --version
flutter doctor -v

确认本地 Flutter（含 OH 分支/定制版）满足 sdk 与 flutter 约束。若不满足：

原仓库里的 pubspec.lock 锁定的是「当时的解析结果」，换机器后可能与当前 Flutter / 镜像源不一致。

sh 复制代码

# Windows（cmd）
del pubspec.lock

# macOS / Linux
rm -f pubspec.lock

flutter clean
flutter pub get

说明： pubspec.lock（注意拼写，不是 pubspec.lcok）是依赖锁定文件。删除后由 pub 按当前环境重新解析；若团队要求锁版本一致，应在统一 Flutter 版本下重新生成 lock 并提交，而不是强行混用旧 lock。

在工程根目录执行：

sh 复制代码

flutter clean

并按需手动删除（若仍存在且持续报错）：

根目录：build/、dart_tool/
鸿蒙子工程：ohos/oh_modules、ohos/entry/build（多 entry 或其它模块时，对每个模块下的 build、oh_modules 同样处理）

然后再执行：

sh 复制代码

flutter pub get
flutter build hap
# 或
flutter run -d <设备>

部分错误与 ohos 目录下未安装或未更新 HAR 有关。在确认已安装 Node.js 、ohpm 且版本符合项目说明的前提下，可在 ohos 目录执行依赖安装（具体命令以项目文档为准，常见为）：

sh 复制代码

cd ohos
ohpm install

若项目使用 DevEco Studio，也可在 IDE 中打开 ohos 工程，由 IDE 触发依赖同步后再回到 Flutter 侧构建。

便于对比「原环境」与「本机」：

flutter doctor 确认版本与项目要求一致。
删除 pubspec.lock （或与团队策略一致地重置 lock）→ flutter clean → flutter pub get。
删掉 build/、dart_tool/、ohos/oh_modules、各 entry 下 build 后重编。
在 ohos 下按项目说明执行 ohpm 安装。
若文档要求配置 OHOS_SDK_HOME 、签名等，按 Flutter 转鸿蒙：ohos-sdk 配置与运行报错排查.md 或项目 README 补全本机配置。

按上述顺序执行后，多数「换机/克隆后无法运行」问题可以排除；若仍报错，把 doctor 与完整编译日志 一并提供给维护者即可快速对齐环境差异。