Skip to content
Flutter Version Manager. Flutter 多版本管理工具。 本地缓存安装多个 Flutter 版本,随时快速切换
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github/workflows feat: create github action go Dec 13, 2019
cmd chore(release): 0.3.1 Feb 18, 2020
.gitignore feat: first version of fvm. All commands are available Dec 7, 2019 chore(release): 0.3.1 Feb 18, 2020
go.mod feat: fvm use <version> globally Dec 15, 2019
go.sum feat: fvm use <version> globally Dec 15, 2019
main.go feat: first version of fvm. All commands are available Dec 7, 2019


Flutter Version Management: A simple cli to manage Flutter SDK versions.


  • Configure Flutter SDK version per project or globally
  • Ability to install and cache multiple Flutter SDK Versions
  • Easily switch between Flutter channels & versions

Version Management

This tool allows you to manage multiple channels and releases, and caches these versions locally, so you don't have to wait for a full setup every time you want to switch versions.

Also, it allows you to grab versions by a specific release, i.e. 1.2.0. In case you have projects in different Flutter SDK versions and do not want to upgrade.


To Install fvm:

brew tap befovy/taps
brew install fvm

Or install fvm through go get

> go get -u -v

The command above will install binary executable fvm file to $GOPATH/bin.
Add $GOPATH/bin to your system PATH, or move the binary fvm file to an existing PATH directory.

And then, for information on each command:

> fvm help


fvm use environment variable FVM_HOME as a working path.
The installed cache and config file are all stored in this path.

If no FVM_HOME in environment variable, fvm will use the default value returned by os.UserConfigDir() append fvm.
On Mac OS, default FVM_HOME is $HOME/Library/Application Support/fvm

Install a SDK Version

FVM gives you the ability to install many Flutter releases or channels.

> fvm install <version>

Use master to install the Master channel and v1.8.0 to install the release.

Use a SDK Version

You can use the installed Flutter SDK versions for your computer user account globally. To do that just:

> fvm use <version>

Also, you can use different Flutter SDK versions per project. To do that you have to go into the root of the project and:

> fvm use <version> --locol

Show current SDK info

Get current active Flutter sdk version, link path and actually path

> fvm current

Remove a SDK Version

Using the remove command will uninstall the SDK version locally. This will impact any projects that depend on that version of the SDK.

> fvm remove <version>

List Installed Versions

List all the versions that are installed on your machine.

> fvm list

Running Flutter SDK

Call Global SDK

After add fvm global path to your system environment variable, flutter command is usable every where.

Your will get tip when you run fvm use <version> firstly.

Proxy Commands

Flutter command within fvm proxies all calls to the CLI just changing the SDK to be the local one.

> fvm flutter run

This will run flutter run command using the local project SDK. If no FVM config is found in the project. FMV will recursively try for a version in a parent directory.

If FVM config is still not found, this will run flutter run command using the global Flutter SDK.

Call Local SDK Directly

FVM creates a symbolic link within your project called .fvmbin/flutter which links to the installed version of the SDK.

Add $(pwd)/fvmbin to your PATH, or

> ./fvmbin/flutter run

This will run flutter run command using the local project SDK.

As an example calling fvm flutter run is the equivalent of calling flutter run using the local project SDK.


This project is licensed under the Apache License 2.0 License - see the LICENSE file for details

You can’t perform that action at this time.