Урок 0. Установка Flutter и настройка редактора

В этом уроке поставим Flutter SDK, подключим его к редактору и проверим, что всё работает. Урок подходит для Windows, macOS и Linux; после него можно переходить к первому приложению.

Содержание:

1. Что понадобится
2. Скачайте Flutter
3. Добавьте Flutter в PATH
4. Подключите редактор
5. Проверка: flutter doctor
6. Частые ошибки
7. Обновление Flutter
8. Итог

1. Что понадобится

Редактор. Проще всего начать с VS Code — скачайте и установите его с code.visualstudio.com . Если вы привыкли к Android Studio, подойдёт и она.

Терминал. Команды этого урока вводятся в терминале: в Windows — PowerShell, в macOS и Linux — «Терминал». Как его открыть и вставить команду, рассказано в начале страницы Установка Git для Flutter .

Git. Flutter скачивается через Git, и сама команда flutter без него не работает — останавливается с ошибкой Error: Unable to find git in your PATH. Возможно, Git у вас уже стоит — проверьте:

git --version

Если напечаталась версия, переходите к разделу 2. На macOS без инструментов разработчика вместо версии откроется окно установки — нажмите Install : это и есть установка Git. Иначе поставьте Git:

• Windows — в PowerShell:

winget install --id Git.Git -e --source winget

• macOS — команда поставит инструменты командной строки Xcode, в них есть Git; в появившемся окне нажмите Install :

xcode-select --install

• Linux (Ubuntu, Debian) — Git и пакеты, которые нужны Flutter:

sudo apt-get update -y && sudo apt-get upgrade -y && sudo apt-get install -y curl git unzip xz-utils zip libglu1-mesa

sudo попросит пароль вашей учётной записи; символы при вводе не отображаются — наберите пароль и нажмите Enter .

После установки откройте новое окно терминала: уже открытые окна не видят изменений PATH, которые сделал установщик. Подробности и частые ошибки — на странице Установка Git для Flutter .

Где запускать. Для первых уроков хватит браузера: чтобы запускать приложение в вебе, нужен только Chrome или Edge. Android Studio, Xcode и Visual Studio понадобятся позже — когда захотите запускать на телефоне или как настольную программу (раздел 5).

2. Скачайте Flutter

Flutter скачивается одной командой: Git клонирует стабильную версию в папку develop/flutter в вашей домашней папке (папки создаются сами). Это займёт несколько минут.

macOS и Linux:

git clone -b stable https://github.com/flutter/flutter.git ~/develop/flutter

Windows (PowerShell):

git clone -b stable https://github.com/flutter/flutter.git $env:USERPROFILE\develop\flutter

В пути к папке не должно быть пробелов и особых символов, и она не должна требовать прав администратора — поэтому не C:\Program Files . Если в имени вашей папки пользователя Windows есть пробел или русские буквы, клонируйте в C:\src\flutter (в конце команды вместо $env:USERPROFILE\develop\flutter ) и в PATH добавьте C:\src\flutter\bin .

3. Добавьте Flutter в PATH

PATH — это список папок, в которых система ищет программы. Добавьте в него flutter/bin , и команда flutter заработает в любом терминале.

Windows — путь сохраняется в настройках системы:

1. Нажмите Windows + Pause (если клавиши Pause нет — Windows + Fn + B ) и откройте Дополнительные параметры системы → Переменные среды .
2. В переменных пользователя выберите Path и нажмите Изменить — откроется список папок. Если строки Path нет, нажмите Создать , введите имя Path и значение из шага 3 — и переходите к закрытию окон.
3. Дважды щёлкните пустую строку списка, введите %USERPROFILE%\develop\flutter\bin , поднимите её в начало списка и закройте все окна кнопкой ОК .

macOS и Linux. Команда export PATH=… , набранная прямо в терминале, действует только в этом окне — в новом окне Flutter снова «не найдётся». Поэтому строку с export дописывают в файл настроек оболочки, который она читает при каждом запуске.

macOS (оболочка по умолчанию — zsh):

echo 'export PATH="$HOME/develop/flutter/bin:$PATH"' >> ~/.zshenv

Linux — две строки, для оболочек bash и zsh: какая у вас, знать не нужно, лишняя строка не мешает:

echo 'export PATH="$HOME/develop/flutter/bin:$PATH"' >> ~/.bashrc
echo 'export PATH="$HOME/develop/flutter/bin:$PATH"' >> ~/.zshenv

Выполните это один раз: >> дописывает строку в конец файла (и создаёт файл, если его нет), а повторный запуск добавит её ещё раз.

После этого закройте и снова откройте все терминалы и редакторы — PATH читается при их запуске.

4. Подключите редактор

VS Code. Откройте панель расширений — значок Extensions слева или Ctrl+Shift+X ( ⇧⌘X в macOS), — найдите Flutter и нажмите Install : вместе с ним установится расширение Dart . Расширение само находит Flutter через PATH, поэтому после раздела 3 перезапустите VS Code. Проверить, что оно видит Flutter, можно командой Flutter: Run Flutter Doctor из палитры команд (раздел 5); версия Flutter в строке состояния внизу окна появится, когда вы откроете проект (Урок 1).

Android Studio.

1. Откройте настройки: File → Settings ( Ctrl+Alt+S ) в Windows и Linux, Android Studio → Settings… ( ⌘, ) в macOS.
2. Выберите Plugins , вкладку Marketplace , наберите flutter и нажмите Install , на вопрос об установке — Yes . Вместе с Flutter установится плагин Dart.
3. Нажмите Restart , чтобы перезапустить Android Studio.

Путь к SDK Android Studio спросит при создании первого проекта ( New Flutter Project → Flutter SDK path ) — укажите папку flutter : ~/develop/flutter в macOS и Linux, %USERPROFILE%\develop\flutter в Windows. Поменять его можно в настройках: Languages & Frameworks → Flutter .

5. Проверка: flutter doctor

Откройте новый терминал (в VS Code — Terminal → New Terminal ) и выполните:

flutter --version

Первый запуск дольше: Flutter докачивает Dart SDK и собирает свой инструмент — в терминале появятся строки Downloading … Dart SDK… и Building flutter tool... . Дождитесь. Затем команда выводит версию Flutter и Dart:

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

Если вместо этого терминал пишет, что команда не найдена, — смотрите раздел 6.

Теперь главная проверка — flutter doctor . Она показывает, какие инструменты установлены и для каких платформ можно собирать приложения:

flutter doctor

Так выглядит ответ на Mac, где Flutter стоит, а Android Studio и Xcode настроены не до конца:

Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, 3.47.9, on macOS 26.6.2 25G83 darwin-arm64, locale ru-RU)
[!] Android toolchain - develop for Android devices (Android SDK version 36.1.0)
    ! Some Android licenses not accepted. To resolve this, run: flutter doctor --android-licenses
[!] Xcode - develop for iOS and macOS (Xcode 27.2)
    ! CocoaPods not installed.
        CocoaPods is a package manager for iOS or macOS platform code.
        Without CocoaPods, plugins will not work on iOS or macOS.
        For more info, see https://flutter.dev/to/platform-plugins
      For installation instructions, see https://guides.cocoapods.org/using/getting-started.html#installation
[✓] Chrome - develop for the web
[✓] Connected device (4 available)
[✓] Network resources

! Doctor found issues in 2 categories.

• [✓] — всё в порядке, [!] — есть проблема или чего-то не хватает, [✗] — инструмент не найден.
• Под строкой с ! или ✗ doctor пишет, что сделать, — часто готовой командой.
• flutter doctor -v показывает то же подробно, с путями к каждому инструменту.

Для начала достаточно двух галочек: Flutter и Chrome . Сообщение про CocoaPods doctor пишет общее: на деле CocoaPods нужен только плагинам, которые ещё не перешли на Swift Package Manager (таблица ниже). Предупреждения про Android Studio или Xcode можно не трогать, пока вы не собираетесь запускать приложение на этих платформах. В VS Code та же проверка — команда Flutter: Run Flutter Doctor из палитры команд, результат появится на панели Output.

Что нужно для каждой платформы:

6. Частые ошибки

«flutter» не является внутренней или внешней командой. Полностью сообщение Windows звучит так: «"flutter" не является внутренней или внешней командой, исполняемой программой или пакетным файлом», в английской Windows — «'flutter' is not recognized as an internal or external command, operable program or batch file». Система не нашла Flutter в PATH:

• проверьте, что в PATH добавлена именно папка flutter\bin , а не flutter ;
• закройте и снова откройте терминал и редактор — открытые раньше окна PATH не перечитывают;
• если VS Code пишет «Could not find a Flutter SDK», нажмите Locate SDK и укажите папку flutter .

«Error: Unable to find git in your PATH». Команда flutter не нашла Git. Установите его (раздел 1), закройте и снова откройте терминал.

«The Flutter SDK is installed in a protected folder and may not function correctly». Flutter лежит в папке, которая требует прав администратора, например C:\Program Files . Перенесите папку flutter в develop и поправьте PATH.

7. Обновление Flutter

Новая версия ставится одной командой:

flutter upgrade

Она обновляет Flutter до последней версии вашего канала. Команда из раздела 2 ставит канал stable — его документация и советует начинающим; новые версии в нём выходят примерно раз в три месяца.

Flutter собирает анонимную статистику использования и отчёты о сбоях. Отключить это:

flutter --disable-analytics

8. Итог

• Git нужен: через него Flutter скачивается, и команда flutter без него не работает.
• Flutter ставится одной командой git clone -b stable … , затем flutter/bin добавляется в PATH.
• Редактору нужно расширение (VS Code) или плагин (Android Studio) Flutter.
• После изменения PATH терминалы и редакторы нужно перезапустить.
• flutter doctor показывает, что готово: для начала нужны галочки у Flutter и Chrome .

Нужно несколько версий Flutter на одном компьютере или своя версия для каждого проекта — об этом отдельная страница: Установка и выбор версии Flutter с помощью FVM .

Дальше: Урок 1. Первое приложение Hello World .

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