Якщо Термінал повертає zsh: command not found: flutter, macOS повідомляє вам, що поточна оболонка не може знайти програму з іменем flutter у каталогах, перелічених у змінній PATH. PATH — це змінна середовища: список папок, які оболонка шукає, коли ви вводите команду. Виправлення зазвичай є простим, але варто перевірити місце встановлення перед редагуванням будь-чого.
Для початківця мета полягає не лише в тому, щоб одне вікно Терміналу розпізнало Flutter один раз. Хорошим результатом є те, що щойно відкрите вікно Терміналу може виконувати flutter --version, dart --version та flutter doctor -v без повідомлення "command not found". Ваша IDE також повинна розпізнати Flutter після перезапуску.
Станом на вересень 2026 року офіційна документація з встановлення Flutter відображає набір документації Flutter 3.47.2. Інструкції щодо PATH для macOS досі передбачають використання стандартної оболонки Apple, Zsh, і радять користувачам додати каталог bin Flutter SDK до ~/.zprofile. Див. офіційні інструкції Flutter щодо PATH. Apple також підтверджує, що Zsh є оболонкою за замовчуванням у Терміналі на поточних версіях macOS: документація Apple щодо оболонки Терміналу.
Вам потрібні дві речі: Flutter SDK, який фактично існує на диску, і точне розташування його папки bin. SDK (Software Development Kit) — це набір інструментів командного рядка Flutter, бібліотек та допоміжних файлів. Папка bin всередині нього містить виконуваний файл, який Термінал повинен знайти.
Якщо ви ще не встановили Flutter, додавання неіснуючої папки до PATH не допоможе. Спочатку дотримуйтесь посібника з ручного встановлення Flutter або офіційного шляху встановлення через VS Code. Поточні інструкції Flutter для macOS пропонують розташування, доступне для запису користувачем, наприклад ~/develop/, для вручну розпакованого SDK.
Відкрийте Термінал і виконайте:
flutter --versionЯкщо ви бачите повідомлення на кшталт zsh: command not found: flutter, підтвердіть, яку оболонку ви використовуєте:
echo $SHELLНа типовому сучасному Mac результатом буде /bin/zsh. Якщо ви використовуєте Bash, Fish або іншу оболонку, не редагуйте файли Zsh навмання; файл запуску специфічний для кожної оболонки.
Далі знайдіть ваш Flutter SDK. Якщо ви дотримувались прикладу ручного встановлення, перевірте:
ls "$HOME/develop/flutter/bin/flutter"Якщо ця команда виводить шлях до файлу, SDK існує, і ймовірна проблема полягає в PATH. Якщо вона повідомляє, що файл не існує, не продовжуйте з прикладом шляху. Спочатку знайдіть реальну папку Flutter. Ви можете використати Finder або пошукати в ймовірних каталогах, які ви обрали під час розпакування SDK.
У документації з усунення несправностей Flutter також зазначається, що якщо VS Code вже налаштовано для Flutter, розширення Flutter може використовувати підказку Locate SDK для ідентифікації папки SDK. Див. усунення несправностей встановлення Flutter.
Для стандартної конфігурації Zsh, задокументованої Flutter для macOS, відкрийте або створіть файл ~/.zprofile. Крапка на початку означає, що це прихований конфігураційний файл у вашому домашньому каталозі.
Ви можете редагувати його будь-яким текстовим редактором. З Терміналу простим варіантом є:
nano ~/.zprofileДодайте цей рядок, замінивши шлях, якщо ваш SDK знаходиться в іншому місці:
export PATH="$HOME/develop/flutter/bin:$PATH"Це означає: поставте каталог bin Flutter на початок існуючого PATH, а потім збережіть усі каталоги, які вже там були. Розміщення Flutter першим корисне, якщо інша застаріла інсталяція Flutter з'являється в іншому місці в PATH.
Збережіть файл. У Nano натисніть Control+O, натисніть Return для підтвердження імені файлу, а потім Control+X для виходу.
~/.zprofile, показаної в статті; зображений редактор є ілюстративним, а не реальним скріншотом.Ви можете побачити старі посібники, які радять редагувати ~/.zshrc. Цей файл може працювати для інтерактивної конфігурації Zsh, але поточна сторінка встановлення Flutter для macOS спеціально інструктує користувачів розміщувати запис PATH у ~/.zprofile. Для нового встановлення дотримання поточного офіційного шляху дозволяє уникнути змішування кількох конвенцій файлів запуску.
Apple пояснює важливу причину, чому важлива постійна конфігурація: змінні середовища, встановлені в одному сеансі оболонки, не з'являються автоматично в інших незалежних сеансах Терміналу, а тимчасові змінні зникають після закриття цього сеансу. Постійні значення повинні належати до файлу запуску оболонки. Див. посібник Apple щодо змінних середовища.
Інструкції Flutter для macOS радять закрити та повторно відкрити всі відкриті сеанси Zsh у додатках терміналу та IDE після зміни PATH. Це легко пропустити. Вікно терміналу, яке вже було відкрито, може досі використовувати старі середовища.
Вийдіть із Терміналу та відкрийте його знову, потім виконайте:
command -v flutter
flutter --version
dart --versioncommand -v flutter повинен вивести шлях до виконуваного файлу Flutter, наприклад:
/Users/yourname/develop/flutter/bin/flutterКоманди версії тепер повинні повертати інформацію про версію, а не "command not found". Не хвилюйтеся, якщо ваші точні номери версій відрізняються від прикладів, які ви бачите в інтернеті; релізи Flutter змінюються з часом.
flutter --version у щойно відкритому терміналі, щоб підтвердити, що команда тепер доступна.Якщо Flutter працює в Терміналі, але досі відсутній у VS Code або іншій IDE, повністю вийдіть із цієї IDE та відкрийте її знову. Офіційна сторінка PATH Flutter явно включає сеанси IDE в додатки, які слід перезапустити після змін середовища.
Як тільки flutter сам по собі працює, помилка PATH вирішена. Наступна команда:
flutter doctor -vflutter doctor перевіряє решту вашого середовища розробки. Для роботи з настільними додатками macOS або iOS він може виявити проблеми, пов'язані з Xcode та іншими інструментами. Офіційний посібник з налаштування Flutter для macOS рекомендує виконати flutter doctor -v, а потім вирішити всі повідомлені завдання перед повторним запуском. Див. посібник з налаштування розробки Flutter для macOS.
Це розрізнення важливе: якщо flutter doctor запускається і повідомляє про проблему з Xcode, у вас більше немає проблеми "Flutter command not found". Зміна PATH знову не виправить відсутню ліцензію Xcode, конфігурацію інструментів командного рядка, проблему з симулятором або іншу залежність інструментарію.
| Що ви бачите | Зазвичай це означає | Що перевірити далі |
|---|---|---|
~/develop/flutter/bin/flutter не існує | Приклад шляху неправильний для вашого Mac, або SDK не було встановлено/розпаковано там. | Знайдіть фактичний SDK перед редагуванням PATH. |
Виконуваний файл існує, але command -v flutter нічого не повертає | Каталог bin Flutter не знаходиться в PATH, завантаженому цією оболонкою. | Перевірте точний рядок у ~/.zprofile, потім перезавантажте Термінал. |
| Flutter працює в одному вікні Терміналу, але не в іншому | Сеанси були запущені з різними середовищами або конфігураціями оболонки. | Закрийте всі вікна Терміналу та почніть новий сеанс; перевірте echo $SHELL. |
| Flutter працює в Терміналі, але не в терміналі IDE | IDE може досі мати старі середовища. | Повністю вийдіть з IDE та відкрийте її знову. |
flutter doctor -v запускається, але повідомляє про інші помилки | PATH вже виправлено; інша залежність Flutter потребує уваги. | Дотримуйтесь конкретного виводу doctor замість повторної зміни PATH. |
.../flutter/bin, а не просто .../flutter./Users/alex/develop/flutter не існуватиме на Mac, де обліковий запис і каталог встановлення відрізняються.:$PATH, щоб зберегти існуючі системні каталоги команд.flutter --version працює, переходьте до flutter doctor -v.Поточна документація Flutter попереджає, що підтримка Mac на базі Intel (x64) поступово припиняється, тоді як Apple Silicon залишається перспективною архітектурою Mac. Ця зміна життєвого циклу зазвичай не пояснює базове повідомлення zsh: command not found: flutter, коли встановлений виконуваний файл просто не знаходиться в PATH. Якщо ви використовуєте Mac на базі Intel і стикаєтеся з проблемами сумісності після виправлення PATH, перевірте поточну сторінку підтримуваних платформ Flutter та архів SDK перед вибором версії Flutter.
У вас надійне налаштування, коли щойно відкрите вікно Терміналу може знайти Flutter без ручних команд, flutter --version та dart --version успішно виконуються, ваша IDE розпізнає SDK після перезапуску, а flutter doctor -v виконується достатньо далеко, щоб повідомити фактичний стан ваших інструментальних засобів розробки.
Якщо ці перевірки пройдено, припиніть змінювати PATH. Будь-які залишкові попередження слід обробляти як окремі проблеми налаштування. Це робить процес усунення несправностей передбачуваним і запобігає ускладненню робочої конфігурації оболонки більше, ніж необхідно.
Виправте помилку незгенерованого Prisma Client, перевіривши генератор, схему, шлях виводу, імпорти, версії, налаштування монорепозиторію та кроки збірки під час розгортання.
Виправте помилку Git «не вдалося отримати локальний сертифікат емітента», визначивши механізм довіри, встановивши правильний ланцюжок ЦС та зберігаючи перевірку SSL увімкненою.
Виправте помилки таймауту мережі MongoDB у Mongoose, визначивши тип таймауту, перевіривши доступність Atlas або TCP, виправивши URI та налаштувавши таймаути лише за необхідності.
Виправте помилку обмеженої політики виконання PowerShell, перевіривши область дії та групову політику, а потім обравши RemoteSigned, Unblock-File або тимчасовий параметр сесії.
Виправте конфлікти залежностей-партнерів npm ERESOLVE, визначивши несумісний діапазон пакетів, узгодивши версії, використовуючи npm explain та npm ls, а також розглядаючи legacy-peer-deps або force лише як контрольовані резервні варіанти.
Виправте помилки відмови у підключенні Redis на 127.0.0.1:6379, перевіривши сервер, порт, мережу Docker, redis.conf, автентифікацію та TLS.
Виправте помилки 500 у серверних компонентах Next.js, аналізуючи логи сервера, перевіряючи запити даних та змінні середовища, обробляючи помилки та перевіряючи збірку для продакшену.
Діагностуйте та виправляйте помилку CrashLoopBackOff у Kubernetes у локальному Minikube, перевіряючи стан пода, попередні логи, причини завершення роботи, проби, конфігурацію, ліміти пам’яті та стан кластера.
Виправте помилку «Docker Desktop Engine Stopped» у Windows 11, перевіривши статус Docker, оновивши та перезавантаживши WSL 2, підтвердивши віртуалізацію та використавши діагностику перед скиданням налаштувань.
Виправте помилку 'process is not defined' у Vite, замінивши використання process.env у стилі Node.js, правильно налаштувавши змінні VITE_ та перевіривши залежності.
