如何在pubspec.yaml中使用自定义Flutter Fork？适配团队与CI/CD

首先明确：pubspec.yaml无法直接配置自定义Flutter Fork——Flutter是完整的开发SDK，并非普通的pub依赖包，因此不能通过pubspec的依赖声明来指定自定义版本。以下是几种可行的落地方案：

方案1：直接通过Git管理自定义Flutter SDK #

将你的Flutter Fork托管到GitHub后，团队成员和CI/CD环境统一从这个Fork拉取SDK，而非官方源：

• 本地操作：
  1. 克隆你的自定义Flutter仓库：git clone https://github.com/你的用户名/flutter.git
  2. 切换到包含你修改的分支：git checkout 你的自定义分支
  3. 将该SDK的bin目录添加到系统环境变量，或在IDE中指定该SDK路径
  4. 运行flutter doctor确认环境正常后即可开发
• GitHub Actions配置：
  跳过官方的setup-flutter动作，直接克隆你的Fork并配置环境：

  steps:
    - name: 克隆自定义Flutter SDK
      uses: actions/checkout@v4
      with:
        repository: 你的用户名/flutter
        ref: 你的自定义分支
        path: flutter-sdk
    - name: 配置Flutter环境变量
      run: echo "$GITHUB_WORKSPACE/flutter-sdk/bin" >> $GITHUB_PATH
    - name: 验证环境
      run: flutter doctor
    - name: 构建项目
      run: flutter build apk # 根据你的平台调整命令
  

方案2：用FVM（Flutter版本管理工具）统一管理 #

FVM支持绑定自定义Git源的Flutter版本，能简化团队成员的环境同步，同时适配CI/CD流程：

• 本地操作：
  1. 安装FVM：pub global activate fvm
  2. 添加自定义Flutter版本：fvm install git@github.com/你的用户名/flutter.git:你的分支名
  3. 在项目根目录创建.fvmrc文件，写入自定义版本标识（比如git@github.com/你的用户名/flutter.git:你的分支名）
  4. 团队成员拉取项目后，运行fvm use即可自动切换到统一的自定义SDK
• GitHub Actions配置：

  steps:
    - name: 安装FVM
      run: pub global activate fvm
    - name: 拉取自定义Flutter SDK
      run: fvm install git@github.com/你的用户名/flutter.git:你的分支名
    - name: 构建项目
      run: fvm flutter build apk # 用fvm前缀执行Flutter命令
  

关键注意事项 #

• 定期同步官方Flutter仓库的最新代码到你的Fork，避免自定义版本与官方版本差距过大，减少后续合并冲突
• 所有对Flutter源码的修改都提交到Fork的固定分支，团队成员统一基于该分支开发，确保环境完全一致

内容的提问来源于stack exchange，提问作者Özgür Özerk