Установка и выбор версии Flutter с помощью FVM

FVM (Flutter Version Management) — программа, которая держит на компьютере несколько версий Flutter и закрепляет нужную за каждым проектом. Пригодится, когда старый проект живёт на одной версии, а новый — на другой, или когда все разработчики проекта должны собирать его одной и той же версией.

Для первых уроков FVM не нужен — хватит обычной установки из Урока 0 . Создатели FVM и сами советуют держать обычный Flutter как основную версию на компьютере, а FVM — для версий проектов.

Содержание:

1. Установка FVM
2. Скачать версию Flutter
3. Выбрать версию для проекта
4. Запуск через FVM
5. Настройка редактора
6. Полезные команды
7. Итог

1. Установка FVM

FVM скачивает Flutter через Git — он должен быть установлен (как его поставить — на странице Установка Git ).

macOS — через Homebrew :

brew tap btwld/fvm
brew install btwld/fvm/fvm

Linux — установочным скриптом. Он ставит FVM в папку ~/fvm/bin без sudo , но PATH сам не меняет, поэтому вторая и третья строки дописывают путь в файлы настроек оболочек bash и zsh (как в Уроке 0 ):

curl -fsSL https://fvm.app/install.sh | bash
echo 'export PATH="$HOME/fvm/bin:$PATH"' >> ~/.bashrc
echo 'export PATH="$HOME/fvm/bin:$PATH"' >> ~/.zshenv

После этого откройте новое окно терминала.

Windows — через Chocolatey : откройте PowerShell с правами администратора (Chocolatey требует их; в меню «Пуск» щёлкните PowerShell правой кнопкой → «Запуск от имени администратора») и выполните:

choco install fvm

Через Chocolatey FVM ставится только на x64. Если Chocolatey у вас нет или компьютер на ARM64, документация FVM предлагает архив со страницы релизов : распакуйте его и добавьте папку fvm в PATH, как папку Flutter в Уроке 0.

Проверка:

fvm --version

Команда печатает номер версии FVM, например 4.1.2 .

2. Скачать версию Flutter

Список версий Flutter, которые можно поставить:

fvm releases

В конце списка — последняя версия канала stable:

Channel:
┌─────────┬─────────┬──────────────┐
│ Channel │ Version │ Release Date │
├─────────┼─────────┼──────────────┤
│ stable  │ 3.47.9  │ Oct 29, 2026 │
└─────────┴─────────┴──────────────┘

Скачать нужную версию:

fvm install 3.47.9

Версии хранятся в общей папке ~/fvm/versions (в Windows — %USERPROFILE%\fvm\versions ) — каждая скачивается один раз и подходит для любого проекта. Что уже скачано, покажет fvm list .

3. Выбрать версию для проекта

Проще всего — открыть проект в VS Code и выполнить команду во встроенном терминале ( Terminal → New Terminal ): он открывается в папке проекта, и FVM заодно сам настроит VS Code (раздел 5). Первый проект создадим в Уроке 1 .

fvm use 3.47.9

Если в папке нет pubspec.yaml , FVM предупредит «No pubspec.yaml detected in this directory» и спросит «Would you like to continue?» — ответьте n и перейдите в папку проекта.

В конце FVM сообщит:

✓ Project now uses Flutter SDK : SDK Version : 3.47.9

Что произошло:

• в корне проекта появился файл .fvmrc с версией — его стоит хранить в Git, чтобы у всех разработчиков проекта была одна версия:

{
  "flutter": "3.47.9"
}

• появилась папка .fvm со ссылками на скачанную версию: flutter_sdk и versions/3.47.9 ; в .gitignore добавилась строка .fvm/ — эту папку в Git не кладут;
• если версия ещё не скачана, fvm use скачает её сам;
• FVM выполнил flutter pub get и, если в проекте есть папка .vscode , прописал версию в настройки VS Code.

Коллеге, который скачал проект с .fvmrc , достаточно выполнить в папке проекта fvm install без номера — FVM возьмёт версию из файла.

4. Запуск через FVM

Команды Flutter и Dart теперь запускаются через FVM — тогда берётся версия проекта:

fvm flutter run
fvm flutter --version
fvm dart --version

fvm flutter --version в нашем проекте:

Flutter 3.47.9 • channel stable • https://github.com/flutter/flutter.git
Framework • revision c197ca5199 (11 days ago) • 2026-10-29 10:10:20 -0400
Engine • hash 9e025265bef30b838c0c1b68cad19decf97048f2 (revision 89c39edfdf) (12 days ago) • 2026-10-27 19:51:20.000Z
Tools • Dart 3.13.7 • DevTools 2.60.0

Какую версию взять, FVM решает по порядку: .fvmrc в папке проекта, затем .fvmrc в папках выше, затем версия по умолчанию ( fvm global ), затем Flutter из PATH. Поэтому лишний .fvmrc в папке выше проекта может незаметно подменить версию.

5. Настройка редактора

VS Code. Если fvm use выполнен во встроенном терминале VS Code или в проекте есть папка .vscode , FVM сам записывает в .vscode/settings.json путь к версии проекта:

{
  "dart.flutterSdkPath": ".fvm/versions/3.47.9"
}

Android Studio. FVM не меняет её настройки — после fvm use версию проекта нужно указать самой Android Studio (плагин Flutter должен быть установлен, Урок 0 ):

1. Откройте настройки: File → Settings в Windows и Linux, Android Studio → Settings… в macOS.
2. Выберите Languages & Frameworks → Flutter .
3. В поле Flutter SDK path вставьте полный путь к проекту с .fvm/flutter_sdk на конце — например, /Users/me/projects/my_app/.fvm/flutter_sdk или C:\Users\me\projects\my_app\.fvm\flutter_sdk . Именно папку SDK, не её bin , и без / в конце. Путь лучше вставить текстом, а не выбирать в окне папок: так некоторые версии Android Studio сохраняют ссылку FVM.
4. Нажмите Apply и сверьте версию, которую показывает Android Studio, с выводом fvm flutter --version в терминале.

Если для Android-части проекта что-то не подхватилось, выполните Sync Project with Gradle Files (найти команду можно через Find Action ).

После смены версии ( fvm use 3.44.9 и т. п.) снова откройте Languages & Frameworks → Flutter : если версия там не поменялась, некоторые версии Android Studio при сохранении заменили ссылку на путь к конкретной версии — выберите путь .fvm/flutter_sdk заново.

6. Полезные команды

Windows: ошибка Git про safe.directory . Если после установки на Windows FVM не находит Git, хотя git --version работает, — Git блокирует папку с версиями Flutter. Документация FVM предлагает команду:

git config --global --add safe.directory "*"

После неё перезапустите терминал и редактор.

7. Итог

• FVM ставится через Homebrew на macOS, скриптом на Linux, через Chocolatey на Windows.
• fvm install <версия> скачивает Flutter в общую папку, fvm use <версия> закрепляет версию за проектом в .fvmrc .
• Команды Flutter запускаются через fvm flutter … , редактору указывается SDK из папки проекта.

Подробнее — в документации FVM .

Вопросы и предложения — на contact@flutter.su.