Flutter Linux版如何进行版本管理

Linux 上管理 Flutter 版本的主流做法

• 使用 Flutter 自带的 channel 在 stable / beta / dev / master 之间切换，适合个人学习或单一项目随官方节奏更新的场景。优点是原生支持、切换简单；缺点是只能全局生效、无法多版本共存、无法精确锁定到某个 tag/commit，团队协作时容易出现环境不一致。配合 flutter upgrade 可升级到当前通道最新版本。

• 使用 FVM（Flutter Version Manager） 进行按项目版本管理与多版本共存，适合多项目并行、需要精确锁定版本（含 tag/commit）、以及 CI/CD 稳定复现构建的场景。FVM 会在项目根目录生成 .fvm/ 配置，便于团队统一版本；支持全局/项目级切换，减少全局环境被意外改动的风险。

• 使用通用版本管理器 asdf 管理 Flutter 版本，适合已经使用 asdf 管理多语言/多工具链的团队。通过 asdf 插件安装 flutter，可在不同项目设置 global/local 版本，统一工具链治理体验。

• 使用 Puro 作为替代方案，强调更快的安装与切换（全局 Git 对象去重、引擎共享缓存），并支持全局或按项目环境管理、自动同步 VS Code/IntelliJ 的 SDK 设置，适合对磁盘占用与切换性能敏感的场景。

FVM 实操步骤（Linux 推荐）

1. 安装 FVM（示例为 Linux + Homebrew）

   • 安装命令：

     brew tap leoafarias/fvm
     brew install fvm
     

   • 将 FVM 的默认 bin 目录加入 PATH（写入 ~/.bashrc 或 ~/.zshrc）：

     echo 'export PATH="$HOME/fvm/default/bin:$PATH"' >> ~/.zshrc
     source ~/.zshrc
     

   • 验证：

     fvm --version
     

   说明：FVM 允许多个 Flutter 版本共存，并通过项目级配置实现版本锁定与快速切换。

2. 常用 FVM 命令

   # 查看已安装版本
   fvm list
   
   # 为当前项目使用指定版本（会生成 .fvm/ 配置）
   fvm use 3.19.6
   
   # 全局默认版本
   fvm global stable
   
   # 移除某版本
   fvm remove 3.16.0
   
   # 在项目的 Flutter 环境中执行命令（如 pub、build）
   fvm flutter pub get
   fvm flutter build apk
   

   说明：项目级使用时会创建 .fvm/ 目录（含版本配置与符号链接），便于团队协作与 CI 脚本稳定引用。

3. IDE 与团队协作

   • 在 VS Code 安装 Flutter 扩展后，选择 “FVM: Change SDK”，指向项目下的 .fvm/flutter_sdk；或在项目设置中指定 Flutter SDK 路径为项目内的 FVM 目录。
   • 将 .fvm/ 加入版本控制（通常不包含缓存与临时文件），确保团队成员与 CI 使用一致的 SDK 版本。

使用 Flutter 内置 channel 的要点

• 查看与切换通道：

  flutter channel
  flutter channel stable
  flutter upgrade
  

• 特点与局限：
  • 仅支持官方通道，不能精确指定某个 tag/commit；切换是全局生效，不适合多项目并行且版本不同的场景。
  • 适合个人学习、单一项目、或希望跟随官方稳定/尝鲜节奏的开发者。

多版本共存与切换工具对比

说明：FVM 侧重“项目级锁定与明确性”，Puro 侧重“安装/切换性能与存储优化”，asdf 提供“统一的多语言版本管理体验”。

常见问题与建议

• 切换或升级后执行 flutter doctor 检查依赖，必要时运行 flutter precache 拉取工具链与引擎，避免因环境不一致导致构建失败。
• 团队协作建议始终使用 FVM 项目级配置 或锁定具体 版本号/tag，并在仓库中固化配置，减少“我电脑能跑”的环境差异问题。
• 在 CI/CD 中通过 FVM 指定版本（如 fvm use 后执行构建），确保每次构建使用相同 SDK，提升稳定性与可复现性。