Home

深色模式

FVM 使用参考 ​

FVM (Flutter Version Management) 是 Flutter 版本管理工具，用于在同一台机器上管理多个 Flutter 版本。

安装 ​

bash
# 通过 pub 安装
dart pub global activate fvm

# 通过 Homebrew 安装 (macOS)
brew tap leoafarias/fvm
brew install fvm

基本命令 ​

版本管理 ​

bash
# 列出可用的 Flutter 版本
fvm releases

# 安装指定版本
fvm install 3.16.0
fvm install stable
fvm install beta

# 列出已安装的版本
fvm list

# 删除指定版本
fvm remove 3.16.0

项目配置 ​

bash
# 为当前项目设置 Flutter 版本
fvm use 3.16.0

# 为当前项目设置稳定版
fvm use stable

# 全局设置默认版本
fvm global 3.16.0

运行命令 ​

bash
# 使用项目配置的版本运行 Flutter 命令
fvm flutter --version
fvm flutter pub get
fvm flutter run
fvm flutter build apk

# 使用指定版本运行
fvm flutter --flavor=3.16.0 --version

项目配置文件 ​

使用 fvm use 后会在项目根目录生成 .fvm/fvm_config.json：

json
{
  "flutterSdkVersion": "3.16.0"
}

VS Code 集成 ​

在 .vscode/settings.json 中配置：

json
{
  "dart.flutterSdkPath": ".fvm/flutter_sdk",
  "search.exclude": {
    "**/.fvm": true
  },
  "files.watcherExclude": {
    "**/.fvm": true
  }
}

常用场景 ​

切换版本 ​

bash
# 切换到稳定版
fvm use stable

# 切换到特定版本
fvm use 3.16.0

# 临时使用不同版本
fvm flutter --flavor=beta doctor

清理缓存 ​

bash
# 清理未使用的版本
fvm list
fvm remove <version>

注意事项 ​

  1. 路径配置：确保 FVM 在 PATH 中
  2. IDE 配置：需要配置 IDE 指向 .fvm/flutter_sdk
  3. 团队协作：将 .fvm/fvm_config.json 加入版本控制，.fvm/flutter_sdk 加入 .gitignore
  4. 全局命令：使用 fvm flutter 而不是直接使用 flutter

文件结构 ​

project/
├── .fvm/
│   ├── fvm_config.json  # 版本配置（加入git）
│   └── flutter_sdk/     # 符号链接（忽略）
└── .gitignore           # 添加 .fvm/flutter_sdk

快捷操作 ​

bash
# 一键设置新项目
fvm use stable && fvm flutter pub get

# 检查当前版本
fvm flutter --version

# 升级FVM
dart pub global activate fvm