Ако Терминалът връща 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; стартовият файл е специфичен за шелa.
След това намерете вашия 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 обяснява важна причина, поради която персистентната конфигурация е важна: променливите на средата, зададени в една сесия на шелa, не се появяват автоматично в други независими сесии на Терминала, а временните променливи изчезват, когато сесията се затвори. Персистентните стойности принадлежат на стартовия файл на шелa. Вижте ръководството на 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. Официалната страница на Flutter за PATH изрично включва сесиите на IDE в приложенията, които трябва да бъдат рестартирани след промени в средата.
След като flutter сам по себе си работи, грешката в PATH е решена. Следващата команда е:
flutter doctor -vflutter doctor проверява останалата част от вашата среда за разработка. За работа с десктоп на macOS или iOS той може да идентифицира проблеми, свързани с Xcode и други инструменти. Официалното ръководство за настройка на Flutter за macOS препоръчва да изпълните flutter doctor -v и след това да разрешите всички докладвани задачи, преди да го изпълните отново. Вижте ръководството за настройка на разработка за macOS на Flutter.
Това разграничение е важно: ако 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 работи в един прозорец на Терминала, но не и в друг | Сесиите са стартирани с различни среди или конфигурации на шелa. | Затворете всички прозорци на Терминала и стартирайте нова сесия; проверете 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. Ако сте на Intel Mac и срещнете проблеми със съвместимостта след поправяне на PATH, проверете текущата страница на Flutter за поддържани платформи и архива на SDK, преди да изберете версия на Flutter.
Имате надеждна настройка, когато новосъздаден прозорец на Терминала може да намери Flutter без ръчни команди, flutter --version и dart --version работят успешно, вашето IDE разпознава SDK-а след рестартиране и flutter doctor -v работи достатъчно дълго, за да докладва реалното състояние на вашите инструментални вериги за разработка.
Ако тези проверки минат, спрете да променяте PATH. Всички останали предупреждения трябва да се третират като отделни проблеми с настройката. Това прави процеса на отстраняване на неизправности предвидим и предотвратява работеща конфигурация на шелa да стане по-сложна от необходимото.
Поправете грешката "process is not defined" във Vite, като замените използването на process.env в стил Node.js, конфигурирате правилно променливите с префикс VITE_ и проверите зависимостите.
Поправете грешките за липса на памет в PyTorch CUDA с практичен работен процес: измерете паметта на GPU, намалете работния набор, използвайте AMP и акумулиране на градиенти, създайте контролни точки на активациите и настройте аллокатора само когато е необходимо.
Поправете грешката за липсващ Access-Control-Allow-Origin CORS в Express.js, като диагностицирате произхода, конфигурирате cors безопасно, обработвате предварителните заявки (preflight) и проверявате заглавните редове.
Поправете грешката на React „Cannot read properties of undefined (reading 'map')“, като проследите undefined стойността, коригирате състоянието и данните от API и добавите безопасни предпазители при рендиране.
Поправете грешката на Webpack „Can’t resolve 'fs'“, като изберете правилното решение: преместете кода, предназначен само за Node, от сървърната страна, използвайте зависимост, безопасна за браузър, задайте fs:false само когато е опционално, или задайте правилната цел за Node.
Поправете липсващи Supabase API ключове в Next.js, Vite, Node, деплойменти и Edge Functions. Използвайте текущите имена на publishable/secret ключовете, правилните env файлове и безопасни стъпки за проверка.
Поправете грешката „flutter: command not found“ на macOS, като локализирате Flutter SDK, добавите папката bin към PATH, презаредите Zsh и проверите настройките.
Поправете грешката „Порт 8080 вече се използва“, като намерите процеса, който притежава порта, спрете го безопасно, обработете Docker или изберете нов порт.
Поправете грешката на Django SECRET_KEY must not be empty, като проверите активния модул за настройки, променливите на средата, генерирането на ключ и конфигурацията за продуктивна среда.
Поправете грешката „connection refused“ на localhost:5432, като проверите статуса на сървъра, pg_isready, слушането на порта, postgresql.conf, Docker мапиранията и автентикацията.
