Skip to main content

Flutter版本管理

在 Flutter 的日常开发中，版本管理是一个绕不开的痛点。 不同项目依赖的 Flutter SDK 版本不一致，手动切换 SDK 路径、频繁更新环境变量，不仅麻烦还容易出错。

幸运的是，我们有一个高效优雅的解决方案——FVM (Flutter Version Management)。 它能帮助我们轻松地管理多个 Flutter 版本，并让每个项目都绑定到自己的版本环境中。

一、为什么要用 FVM？​

很多开发者在升级 Flutter SDK 后，会出现以下问题：

  • 老项目跑不起来（依赖旧版本 SDK）
  • 各项目混用同一套环境导致冲突
  • 手动切换 SDK 繁琐（修改 PATH、flutter upgrade 等）

FVM 的核心功能就是解决这些问题：

✅ 多版本共存：同时安装多个 Flutter 版本，不互相干扰 ✅ 项目独立环境：每个项目可绑定不同 Flutter SDK ✅ 自动切换版本：进入项目目录后自动使用对应 Flutter 版本 ✅ 快速切换和升级：一条命令完成版本切换

二、FVM 安装​

📘 官方文档：https://fvm.app/documentation/getting-started/installation

Windows 安装方式一（官方推荐）​

使用 Chocolatey（Windows 包管理工具）：

choco install fvm

但这种方式需要先安装 Chocolatey，对系统“极简控”的开发者来说不太友好。

Windows 安装方式二（推荐）​

直接从 GitHub 下载 FVM 可执行包：

👉 https://github.com/befovy/fvm/releases

下载对应版本的压缩包（例如 fvm-x86_64-pc-windows-msvc.zip），解压后：

  1. 把解压目录路径加入系统环境变量 Path

  2. 重启终端

  3. 验证是否安装成功：

    fvm --version

如果能正确输出版本号，说明安装成功 🎉

三、FVM 基本配置与使用​

1️⃣ 安装 Flutter 版本​

fvm install 3.24.0

FVM 会从 Flutter 官方仓库下载对应版本 SDK，并存放在：

%USERPROFILE%\.fvm\versions

2️⃣ 为项目绑定指定版本​

在你的 Flutter 项目目录中执行：

fvm use 3.24.0

该命令会在项目根目录生成一个 .fvm/fvm_config.json 文件，记录项目所使用的 Flutter 版本。

3️⃣ 使用绑定的 Flutter 运行项目​

以后在该项目中执行 Flutter 命令时，建议使用：

fvm flutter run
fvm flutter pub get
fvm flutter build apk

这样就能确保所有操作都在绑定版本的 Flutter 环境中执行。

四、全局设置（可选）​

你也可以将 FVM 版本设置为全局默认版本：

fvm global 3.24.0

然后在FVM中有一个default代表默认的SDK版本号

六、常用命令速查表​

操作命令
查看已安装版本fvm list
安装指定版本fvm install <version>
切换项目版本fvm use <version>
设置全局版本fvm global <version>
删除版本fvm remove <version>
使用绑定版本运行fvm flutter run
Last updated on by Hanami