fvm Flutter多版本管理安装与常用指令

一、安装

• pub.dev - fvm

• fvm 官方安装文档，包含各系统安装方式。

• 也通过 Dart 包管理工具安装 FVM：

$ brew tap leoafarias/fvm
$ brew install fvm

# 或

$ dart pub global activate fvm

环境变量配置建议，在 ~/.zshrc 或 ~/.bashrc 中添加：

• # 确保 FVM 命令和 Flutter 可执行文件优先级最高
  export PATH="$HOME/fvm/default/bin:$HOME/.pub-cache/bin:$PATH"
  
  # 或
  
  export PATH="$PATH":"$HOME/.pub-cache/bin"
  

• 安装版本时，执行没反应，命令行中换个网络.

• Flutter 版本与 Dart 版本对应关系表

• 如果 fvm install xxx 安装不动，需要更换 解释器 的网络。

二、命令速查表

命令	简写	说明	示例
版本管理
fvm install <version>	-	安装指定 Flutter 版本	fvm install 3.16.4
fvm use <version>	-	在当前项目使用指定版本（生成 .fvm 目录）	fvm use stable
fvm global <version>	-	设置全局默认版本	fvm global 3.16.4
fvm remove <version>	fvm rm	删除已安装版本	fvm rm 3.10.0
列表与信息
fvm list	fvm ls	列出已安装版本	fvm ls
fvm releases	fvm list-remote	列出所有可安装版本	fvm releases
fvm version	fvm -v	查看 FVM 自身版本	fvm -v
项目配置
fvm flutter <command>	fvm fl	在当前项目执行 Flutter 命令	fvm fl run
fvm dart <command>	-	在当前项目执行 Dart 命令	fvm dart pub get
缓存与清理
fvm cache clean	-	清理下载缓存	fvm cache clean
fvm config	-	查看/修改 FVM 配置	fvm config --cache-path

---

三、详细说明与示例

1. 版本管理

# 安装稳定版
fvm install stable

# 安装特定版本（支持完整版本号或渠道名）
fvm install 3.16.4
fvm install beta

# 为当前项目指定版本（创建 .fvm 链接）
fvm use 3.16.4

# 设置全局默认版本（所有未配置项目会使用此版本）
fvm global 3.16.4

# 删除旧版本
fvm remove 3.10.0

2. 查询版本

# 查看已安装版本（标 * 的是全局默认版本）
fvm list
# 输出示例：
# * 3.16.4 (global)
#   3.10.0
#   stable

# 查看所有可安装版本
fvm releases

3. 项目级操作

# 在项目目录执行 Flutter 命令（自动使用 .fvm 配置的版本）
fvm flutter pub get
fvm flutter run

# 简写版（部分支持）
fvm fl run

4. 缓存管理

# 清理下载缓存（不会删除已安装版本）
fvm cache clean

# 查看配置（如缓存路径）
fvm config

四、使用（重点）

• 使用了 fvm 管理版本后，重点细节：

  1、使用 $ flutter --version 是使用的 fvm global xxx 设置的全局版本，可以任意地方执行。

  2、使用 $ fvm flutter --version 是使用的 fvm use xxx 设置的当前项目指定版本，必须在项目文件夹内执行。

  千万不要搞混了，直接使用 flutter 直接跑命令，需要区分你的项目是否有指定版本。

  例如：$ flutter run、$ fvm flutter run