Flutter如何设置全局版本文件实现多模块依赖包版本统一管理？

以下是三种常用的实现方案，可根据你的项目结构选择适配：

方案1：公共依赖托管模块（适配所有场景） #

• 新建一个无业务逻辑的轻量级Flutter公共包，命名可自定义，例如shared_dependencies
• 所有跨模块复用的公共依赖统一在该公共包的pubspec.yaml中声明并指定版本
• 各业务模块不需要单独声明公共依赖，仅需要依赖该公共包即可自动继承所有公共依赖的版本
• 版本迭代时仅需修改公共包中的版本号，所有业务模块同步生效

公共包pubspec.yaml示例：

name: shared_dependencies
description: 全局统一管理公共依赖版本
version: 0.0.1

environment:
  sdk: '>=3.0.0 <4.0.0'
  flutter: ">=3.10.0"

dependencies:
  flutter:
    sdk: flutter
  # 所有公共依赖统一写在此处
  dio: ^5.4.0
  flutter_bloc: ^8.1.5
  get_it: ^7.6.7
  shared_preferences: ^2.2.2

业务模块pubspec.yaml引用示例：

dependencies:
  flutter:
    sdk: flutter
  # 仅需依赖公共依赖包即可，无需重复声明dio等公共依赖
  shared_dependencies:
    path: ../shared_dependencies # 相对路径引用，也可使用私有pub地址

方案2：YAML变量引用（适配单仓库Monorepo场景） #

• 适用于所有模块都在同一个代码仓库的场景，无需额外新建模块
• 新版Pub工具支持在pubspec.yaml中使用变量，你可以在根目录的pubspec.yaml顶部定义所有公共依赖的版本常量，子模块直接引用常量即可
• 版本修改时仅需更新根目录的常量值，所有子模块同步生效

根目录pubspec.yaml示例：

name: 项目根目录
description: 主入口/全局配置

# 顶部定义版本变量
vars:
  dio_version: ^5.4.0
  bloc_version: ^8.1.5
  get_it_version: ^7.6.7

# 其余配置省略

子模块pubspec.yaml引用示例：

dependencies:
  flutter:
    sdk: flutter
  # 直接引用根目录定义的版本变量
  dio: ${dio_version}
  flutter_bloc: ${bloc_version}
  get_it: ${get_it_version}

方案3：全局强制版本覆盖（适配临时统一/冲突解决场景） #

• 如果你不想修改各子模块已有的依赖声明，需要快速强制所有模块使用统一版本的依赖，可以使用根目录dependency_overrides配置
• 该配置优先级最高，无论子模块声明的版本是多少，最终编译时都会使用dependency_overrides中指定的版本，也常用来解决依赖冲突问题

根目录pubspec.yaml配置示例：

name: 项目根目录
description: 主入口/全局配置

dependency_overrides:
  # 强制所有模块使用指定版本的依赖
  dio: ^5.4.0
  flutter_bloc: ^8.1.5
  get_it: ^7.6.7

# 其余配置省略

注意事项 #

• 公共依赖托管模块不要引入非通用的业务相关依赖，避免业务模块出现冗余包
• 使用dependency_overrides强制覆盖版本后，要全量测试所有模块的功能兼容性，避免版本差异导致的异常
• 每次修改版本配置后，需要执行flutter pub get同步所有模块的依赖缓存

内容的提问来源于stack exchange，提问作者user2892437