Mac Flutter fvm 多版本管理安装与常用指令（详细使用）

一、安装

pub.dev - fvm
fvm 官方安装文档，包含各系统安装方式。

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

shell 复制代码

sh
 体验AI代码助手
 代码解读
复制代码
$ brew tap leoafarias/fvm
$ brew install fvm

# 或

$ dart pub global activate fvm

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

bash 复制代码

sh
 体验AI代码助手
 代码解读
复制代码
# 确保 FVM 命令和 Flutter 可执行文件优先级最高
export PATH="$HOME/fvm/default/bin:$HOME/.pub-cache/bin:$PATH"

# 或

export PATH="$PATH":"$HOME/.pub-cache/bin"

安装版本时，执行没反应，命令行中换个网络.
Flutter 版本与 Dart 版本对应关系表

二、命令速查表

命令	简写	说明	示例
版本管理
`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. 版本管理

csharp 复制代码

sh
 体验AI代码助手
 代码解读
复制代码
# 安装稳定版
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. 查询版本

bash 复制代码

sh
 体验AI代码助手
 代码解读
复制代码
# 查看已安装版本（标 * 的是全局默认版本）
fvm list
# 输出示例：
# * 3.16.4 (global)
#   3.10.0
#   stable

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

3. 项目级操作

arduino 复制代码

sh
 体验AI代码助手
 代码解读
复制代码
# 在项目目录执行 Flutter 命令（自动使用 .fvm 配置的版本）
fvm flutter pub get
fvm flutter run

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

4. 缓存管理

bash 复制代码

sh
 体验AI代码助手
 代码解读
复制代码
# 清理下载缓存（不会删除已安装版本）
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