用 Melos 解决 Flutter Monorepo 的依赖冲突：一个真实案例

在 Flutter 项目开发中，尤其是采用 Monorepo 架构管理多个相互关联的包时，依赖冲突是一个常见且令人头疼的问题。不同的包可能依赖同一个库的不同版本，导致项目无法编译或运行时出现难以调试的错误。

本文将基于一个 真实的 Flutter Monorepo 项目案例 ，演示如何使用 Melos 自动检测和解决依赖冲突，显著提升开发效率。

1. 问题场景：Dio 版本冲突

假设我们有一个 Flutter Monorepo 项目，包含以下 3 个包：

core_utils （基础工具包）
- 依赖 dio: ^5.0.0（最新稳定版）。
auth_service （身份验证服务包）
- 依赖 dio: ^4.0.0（旧版本）。
main_app （主应用）
- 同时依赖 core_utils 和 auth_service。

当运行 flutter pub get 时，Dart 的依赖解析器会发现 dio 的版本要求冲突，导致报错：

plaintext 复制代码

Because core_utils depends on dio ^5.0.0 and auth_service depends on dio ^4.0.0, version solving failed.

传统解决方案：

手动检查每个包的 pubspec.yaml，尝试调整 dio 版本。
反复运行 flutter pub get 测试兼容性。
可能耗费 10-30 分钟，甚至引入新问题。

2. Melos 的自动化解决方案

Melos 提供了一套完整的工具链，可以 自动检测依赖冲突 ，并 推荐或执行修复方案。

步骤 1：使用 `melos bootstrap` 检测冲突

在项目根目录运行：

bash 复制代码

melos bootstrap

Melos 会执行以下操作：

扫描所有包的 pubspec.yaml ，识别出 core_utils 和 auth_service 的 dio 版本不兼容。
输出清晰的冲突报告（示例）：

plaintext 复制代码

[MELOS] ⚠️  Dependency conflict detected:
  - Package "core_utils" requires dio: ^5.0.0
  - Package "auth_service" requires dio: ^4.0.0
[MELOS] 💡 Suggested solution: Upgrade "auth_service" to use dio: ^5.0.0.

步骤 2：自动修复冲突

Melos 提供两种修复方式：

方案 1：自动升级依赖（推荐）

在 melos.yaml 中配置自动修复脚本：

yaml 复制代码

scripts:
  fix_deps:
    run: melos exec --scope="auth_service" -- flutter pub add dio:"^5.0.0"
    description: "Force upgrade dio to ^5.0.0 in conflicting packages"

然后执行：

bash 复制代码

melos run fix_deps

效果：

Melos 会自动修改 auth_service/pubspec.yaml，将 dio 升级到 ^5.0.0。
无需手动编辑文件，避免人为错误。

方案 2：依赖覆盖（临时方案）

如果某些包暂时无法升级，可以在主应用的 pubspec.yaml 中强制指定版本：

yaml 复制代码

dependency_overrides:
  dio: ^5.0.0

注意：此方法可能掩盖潜在兼容性问题，建议仅作为临时措施。

步骤 3：验证解决

再次运行：

bash 复制代码

melos bootstrap

此时所有包均使用 dio: ^5.0.0，冲突解决，项目可正常编译。

3. 对比：Melos vs 手动解决

步骤	Melos（自动化）	手动解决
检测冲突	一键扫描所有包，输出清晰报告	逐个包运行 `flutter pub deps`
修复冲突	自动升级或提示修改 `pubspec.yaml`	手动编辑文件，反复测试
验证结果	自动重新运行 `bootstrap` 确认无冲突	手动执行 `flutter pub get` 多次
耗时	1 分钟内	10-30 分钟

4. 最佳实践

统一核心库版本
- 在 melos.yaml 中定义共享依赖版本（如 dio、flutter_riverpod）。

CI 集成检查

在 CI 流水线中加入依赖冲突检测：

yaml 复制代码

steps:
  - run: melos bootstrap
  - run: melos exec -- flutter pub outdated --mode=MAJOR

定期同步依赖
- 使用 melos run upgrade 定期更新所有包的依赖。

5. 总结

在 Flutter Monorepo 项目中，依赖冲突是不可避免的，但 Melos 可以将其从"手动噩梦"变成"自动化流水线" ：

✅ 自动检测冲突 ，精准定位问题包。

✅ 一键修复 ，减少人为错误。

✅ 无缝集成 CI/CD，确保团队代码一致性。

如果你的项目正在面临依赖管理难题，现在就尝试 Melos，让开发效率飞升！ 🚀

延伸阅读：

用 Melos 解决 Flutter Monorepo 的依赖冲突：一个真实案例

1. 问题场景：Dio 版本冲突

2. Melos 的自动化解决方案

步骤 1：使用 melos bootstrap 检测冲突

步骤 2：自动修复冲突

方案 1：自动升级依赖（推荐）

方案 2：依赖覆盖（临时方案）

步骤 3：验证解决

3. 对比：Melos vs 手动解决

4. 最佳实践

5. 总结

步骤 1：使用 `melos bootstrap` 检测冲突