解决 Flutter 跨平台项目的依赖冲突与版本问题

1. 依赖树分析

使用以下命令查看依赖关系：

flutter pub deps

或生成可视化依赖图：

flutter pub deps --style=tree

输出示例：

flutter_app
|-- http 1.0.0
|   |-- meta ^1.3.0
|-- provider 6.0.5
|   |-- flutter (sdk)
|   |-- meta ^1.8.0  # 冲突点

2. 版本约束策略

在 pubspec.yaml 中规范版本声明：

dependencies:
  # 精确版本
  bloc: 8.1.2
  
  # 语义化版本
  dio: ^5.0.0    # 允许 5.x.x
  provider: ">=6.0.0 <7.0.0"  # 指定范围

3. 冲突解决方案

方案1：依赖覆盖

dependency_overrides:
  meta: ^1.8.0  # 强制统一版本

⚠️ 临时方案，需尽快解决根本冲突

方案2：版本升级

flutter pub upgrade --major-versions  # 升级主版本
flutter pub upgrade package_name     # 指定包升级

方案3：降级兼容

flutter pub downgrade package_name@version

4. 多平台依赖处理

针对不同平台的依赖配置：

dependencies:
  shared_preferences:
    git:
      url: https://github.com/flutter/plugins
      ref: main
      path: packages/shared_preferences/shared_preferences

5. 工具链辅助

• 版本检测：

  flutter pub outdated
  

  输出：

  Package  Current  Upgradable  Resolvable  Latest  
  bloc     8.1.2    8.1.3       8.1.3       8.1.3   
  dio      5.0.0    5.1.0       5.1.0       6.0.0   # 需验证兼容性
  

• 依赖清理：

  flutter clean && flutter pub get --verbose
  

6. 冲突预防措施

1. 锁定依赖版本：

   flutter pub get --offline  # 使用缓存的依赖
   

2. 版本范围测试：

   dev_dependencies:
     flutter_driver:
       sdk: flutter
       version: ">=2.0.0 <3.0.0"  # 兼容性测试范围
   

3. 分离环境配置：

   flutter:
     flavors:
       development:
         dependencies:
           mockito: ^5.0.0
       production:
         dependencies:
           firebase_core: ^2.0.0
   

7. 常见冲突场景

冲突类型	解决方案
子依赖版本不兼容	使用 dependency_overrides
平台特定依赖冲突	配置 platforms 条件依赖
Flutter SDK 版本约束	升级 Flutter 或降级插件
Git 依赖哈希冲突	明确指定 commit hash 或 tag

验证流程

graph LR
A[检测冲突] --> B{是否可自动解决}
B -->|是| C[执行 pub upgrade]
B -->|否| D[手动指定版本]
D --> E[运行测试]
E --> F[验证多平台]
F --> G[提交 pubspec.lock]

最佳实践：定期执行 flutter pub upgrade --dry-run 预演升级，始终将 pubspec.lock 纳入版本控制，确保团队环境一致。