Ubuntu系统下Flutter如何进行版本管理

Ubuntu系统下Flutter版本管理指南（以FVM为核心）

在Ubuntu系统上进行Flutter版本管理，推荐使用FVM（Flutter Version Management）——一款专为Flutter设计的轻量级版本管理工具。它可以实现多版本Flutter SDK的本地缓存、项目级版本隔离及快速切换，有效解决多项目开发中的版本冲突问题。

一、FVM的安装

FVM支持多种安装方式，以下是Ubuntu系统常用的两种：

1. 通过Dart Pub安装（推荐）
   确保已安装Dart SDK（可通过dart --version验证），然后在终端运行以下命令安装FVM：

   dart pub global activate fvm
   

   安装完成后，需将Dart的全局包路径添加到系统PATH环境变量中（编辑~/.bashrc或~/.zshrc文件）：

   echo 'export PATH="$PATH:$HOME/.pub-cache/bin"' >> ~/.bashrc
   source ~/.bashrc  # 使配置生效
   

2. 通过Shell脚本安装
   直接运行FVM官方提供的安装脚本，自动完成安装及环境配置：

   curl -fsSL https://fvm.app/install.sh | bash
   

安装完成后，通过fvm --version验证是否安装成功（正常输出FVM版本号即为成功）。

二、FVM基础使用

1. 查看可用版本

使用fvm releases命令查看Flutter官方发布的所有版本（包括稳定版stable、测试版beta、开发版master等）：

fvm releases

2. 安装指定版本

• 安装最新稳定版：

  fvm install stable
  

• 安装特定版本（如3.7.0）：

  fvm install 3.7.0
  

3. 列出已安装版本

通过fvm list命令查看当前本地已缓存的Flutter版本：

fvm list

输出示例：

* 3.7.0（当前使用的版本）
  3.13.9
  stable

4. 全局设置默认版本

使用fvm global命令设置全局默认Flutter版本（后续终端直接运行flutter命令将使用该版本）：

fvm global 3.7.0

5. 切换版本

• 全局切换：通过fvm global命令切换全局版本（如切换到stable版）：

  fvm global stable
  

• 项目级切换：进入项目根目录，使用fvm use命令为该项目指定Flutter版本（会在项目目录下生成.fvm文件夹，记录版本信息）：

  cd /path/to/your_project
  fvm use 3.7.0
  

6. 运行Flutter命令

使用FVM管理的Flutter版本时，需通过fvm flutter前缀执行命令（如flutter doctor、flutter build等）：

fvm flutter doctor  # 检查项目环境
fvm flutter run     # 运行项目

三、注意事项

1. 项目版本锁定：为避免团队协作或CI/CD流程中的版本不一致问题，建议在项目根目录下提交.fvm文件夹（包含版本配置），并通过fvm use命令锁定项目所需版本。
2. 环境变量优先级：若安装后仍无法识别fvm命令，需检查PATH环境变量是否包含$HOME/.pub-cache/bin（可通过echo $PATH验证）。
3. 升级FVM：通过Dart Pub升级FVM（dart pub global activate fvm）或通过Shell脚本升级（重新运行安装脚本）。

通过FVM管理Ubuntu系统下的Flutter版本，既能实现多版本的灵活切换，又能保证项目环境的稳定性，是Flutter开发者的高效选择。