Ak Terminál vráti zsh: command not found: flutter, macOS vám hovorí, že aktuálny shell nemôže nájsť program s názvom flutter v adresároch uvedených v premennej PATH. PATH je premenná prostredia: zoznam priečinkov, ktoré shell prehľadáva, keď zadáte príkaz. Oprava je zvyčajne jednoduchá, ale pred úpravou čohokoľvek stojí za to skontrolovať umiestnenie inštalácie.
Pre začiatočníka nie je cieľom len umožniť jednému oknu Terminálu rozpoznať Flutter raz. Dobrým výsledkom je, že novootvorené okno Terminálu dokáže spustiť príkazy flutter --version, dart --version a flutter doctor -v bez hlášky „command not found“. Vaše IDE by malo tiež rozpoznať Flutter po jeho reštartovaní.
K septembru 2026 oficiálna inštalačná dokumentácia Flutteru odráža dokumentačnú sadu Flutter 3.47.2. Inštrukcie pre cestu (PATH) na macOS stále predpokladajú predvolený shell od Apple, Zsh, a používateľom hovoria, aby pridali adresár bin Flutter SDK do súboru ~/.zprofile. Pozri oficiálne inštrukcie Flutteru pre PATH. Apple tiež potvrdzuje, že Zsh je predvolený shell v Termináli na aktuálnych verziách macOS: dokumentácia shellu Apple Terminal.
Potrebujete dve veci: Flutter SDK, ktoré skutočne existuje na disku, a presné umiestnenie jeho priečinka bin. SDK, alebo softvérový vývojársky kit, je súbor nástrojov príkazového riadka Flutter, knižníc a podporných súborov. Priečinok bin vnútri neho obsahuje spustiteľný príkaz, ktorý musí Terminál nájsť.
Ak ste ešte nenainštalovali Flutter, pridanie neexistujúceho priečinka do PATH nepomôže. Najprv postupujte podľa manuálneho inštalačného sprievodcu Flutteru alebo oficiálnej cesty inštalácie cez VS Code. Aktuálne inštrukcie Flutteru pre macOS odporúčajú umiestnenie zapisovateľné používateľom, ako je napríklad ~/develop/, pre manuálne rozbalené SDK.
Otvorte Terminál a spustite:
flutter --versionAk vidíte hlášku ako zsh: command not found: flutter, potvrďte, ktorý shell používate:
echo $SHELLNa typickom aktuálnom Macu je výsledkom /bin/zsh. Ak používate Bash, Fish alebo iný shell, neslepo upravujte súbory Zsh; spúšťací súbor je špecifický pre daný shell.
Ďalej nájdite svoje Flutter SDK. Ak ste postupovali podľa príkladu manuálnej inštalácie, skontrolujte:
ls "$HOME/develop/flutter/bin/flutter"Ak tento príkaz vypíše cestu k súboru, SDK existuje a pravdepodobným problémom je PATH. Ak povie, že súbor neexistuje, nepokračujte s príkladovou cestou. Najprv nájdite skutočný priečinok Flutter. Môžete použiť Finder alebo vyhľadávať pravdepodobné adresáre, ktoré ste si zvolili pri rozbaľovaní SDK.
Dokumentácia riešenia problémov Flutteru tiež uvádza, že ak bol VS Code už nakonfigurovaný pre Flutter, rozšírenie Flutter môže použiť výzvu Locate SDK na identifikáciu priečinka SDK. Pozri riešenie problémov s inštaláciou Flutteru.
Pre predvolené nastavenie Zsh zdokumentované Flutterom na macOS otvorte alebo vytvorte súbor ~/.zprofile. Úvodná tečka znamená, že ide o skrytý konfiguračný súbor vo vašom domovskom adresári.
Môžete ho upraviť ľubovoľným textovým editorom. Z Terminálu je jednoduchou možnosťou:
nano ~/.zprofilePridajte tento riadok a nahraďte cestu, ak je vaše SDK niekde inde:
export PATH="$HOME/develop/flutter/bin:$PATH"To znamená: umiestnite adresár bin Flutteru na začiatok existujúcej premennej PATH a potom ponechajte všetky adresáre, ktoré tam už boli. Umiestnenie Flutteru na prvé miesto je užitočné, ak sa inde v PATH objaví iná zastaraná inštalácia Flutteru.
Uložte súbor. V Nano stlačte Control+O, stlačte Return na potvrdenie názvu súboru a potom Control+X na ukončenie.
~/.zprofile uvedeného v článku; zobrazený editor je ilustračný, nie skutočná snímka obrazovky.Môžete vidieť staršie tutoriály, ktoré hovoria, že máte upraviť ~/.zshrc. Tento súbor môže fungovať pre interaktívnu konfiguráciu Zsh, ale aktuálna inštalačná stránka Flutteru pre macOS konkrétne inštruuje používateľov, aby umiestnili položku PATH do ~/.zprofile. Pre novú inštaláciu dodržiavanie aktuálnej oficiálnej cesty zabraňuje miešaniu viacerých konvencií spúšťacích súborov.
Apple vysvetľuje dôležitý dôvod, prečo je perzistentná konfigurácia dôležitá: premenné prostredia nastavené v jednej relácii shellu sa automaticky nezobrazia v iných nezávislých reláciách Terminálu a dočasné premenné zmiznú, keď sa táto relácia zatvorí. Perzistentné hodnoty patria do spúšťacieho súboru shellu. Pozri sprievodca Apple premennými prostredia.
Inštrukcie Flutteru pre macOS hovoria, že po zmene PATH musíte zavrieť a znovu otvoriť všetky otvorené relácie Zsh v aplikáciách terminálu a IDE. Na to sa ľahko zabudne. Okno terminálu, ktoré bolo už otvorené, môže stále používať staré prostredie.
Ukončite a znovu otvorte Terminál, potom spustite:
command -v flutter
flutter --version
dart --versioncommand -v flutter by malo vypísať cestu k spustiteľnému súboru Flutter, napríklad:
/Users/yourname/develop/flutter/bin/flutterPríkazy verzie by teraz mali vrátiť informácie o verzii namiesto „command not found“. Nemusíte sa znepokojovať, ak sa vaše presné číselné verzie líšia od príkladov, ktoré vidíte online; vydania Flutteru sa časom menia.
flutter --version v novootvorenom termináli, aby ste potvrdili, že príkaz je teraz nájditeľný.Ak Flutter funguje v Termináli, ale stále sa zdá chýbať vo VS Code alebo inom IDE, úplne ukončite a znovu otvorte toto IDE. Oficiálna stránka PATH Flutteru explicitne zahŕňa relácie IDE medzi aplikácie, ktoré by sa mali reštartovať po zmene prostredia.
Akonáhle samotný príkaz flutter beží, chyba PATH je vyriešená. Ďalším príkazom je:
flutter doctor -vflutter doctor kontroluje zvyšok vášho vývojového prostredia. Pre prácu s desktopom macOS alebo iOS môže identifikovať problémy súvisiace s Xcode a inými nástrojmi. Oficiálny sprievodca nastavením Flutteru pre macOS odporúča spustiť flutter doctor -v a potom vyriešiť všetky hlásené úlohy pred jeho opätovným spustením. Pozri sprievodca nastavením vývoja pre macOS od Flutteru.
Toto rozlíšenie je dôležité: ak flutter doctor beží a hlási problém s Xcode, už nemáte problém „Flutter command not found“. Opätovná zmena PATH nevyrieši chýbajúcu licenciu Xcode, konfiguráciu nástrojov príkazového riadka, problém so simulátorom alebo inú závislosť toolchainu.
| Čo vidíte | Čo to zvyčajne znamená | Čo skontrolovať ďalej |
|---|---|---|
~/develop/flutter/bin/flutter neexistuje | Príkladová cesta je pre váš Mac nesprávna alebo SDK nebolo nainštalované/rozbalené tam. | Nájdite skutočné SDK pred úpravou PATH. |
Spustiteľný súbor existuje, ale command -v flutter nevráti nič | Adresár bin Flutter nie je v PATH načítanom týmto shellom. | Skontrolujte presný riadok v ~/.zprofile a potom znovu otvorte Terminál. |
| Flutter funguje v jednom okne Terminálu, ale nie v druhom | Relácie boli spustené s rôznymi prostrediami alebo konfiguráciami shellu. | Zavrite všetky okná Terminálu a spustite novú reláciu; overte echo $SHELL. |
| Flutter funguje v Termináli, ale nie v termináli IDE | IDE môže mať stále staré prostredie. | Úplne ukončite IDE a znovu ho otvorte. |
flutter doctor -v beží, ale hlási iné chyby | PATH je už opravené; iná závislosť Flutteru si vyžaduje pozornosť. | Nasledujte konkrétny výstup doctora namiesto opätovnej zmeny PATH. |
.../flutter/bin, nie len .../flutter./Users/alex/develop/flutter nebude existovať na Macu, kde sa účet a inštalačný adresár líšia.:$PATH, aby ste zachovali existujúce adresáre príkazov systému.flutter --version funguje, prejdite na flutter doctor -v.Aktuálna dokumentácia Flutteru varuje, že podpora pre Macy založené na procesoroch Intel (x64) sa postupne ukončuje, zatiaľ čo Apple Silicon zostáva perspektívnou architektúrou Macu. Táto zmena životného cyklu zvyčajne nevysvetľuje základnú hlášku zsh: command not found: flutter, keď nainštalovaný spustiteľný súbor jednoducho nie je v PATH. Ak ste na Macu s Intelom a po oprave PATH narazíte na problémy s kompatibilitou, skontrolujte aktuálnu stránku podporovaných platforiem Flutteru a archív SDK pred výberom verzie Flutteru.
Máte spoľahlivé nastavenie, keď novootvorené okno Terminálu dokáže nájsť Flutter bez manuálnych príkazov, flutter --version a dart --version bežia úspešne, vaše IDE rozpozna SDK po reštarte a flutter doctor -v beží dostatočne ďaleko na to, aby hlásil skutočný stav vašich vývojových toolchainov.
Ak tieto kontroly prejdú, prestaňte meniť PATH. Akékoľvek zostávajúce varovania by sa mali riešiť ako samostatné problémy s nastavením. To udržiava proces riešenia problémov predvídateľný a zabraňuje tomu, aby funkčná konfigurácia shellu bola zbytočne zložitá.
Opravte neaktualizované štýly CSS v Tailwind vo Vite React kontrolou nastavenia Tailwind v4, importu CSS, detekcie zdrojov, dynamických tried, HMR a zastaraných vyrovnávacích pamätí.
Oprava chyby ModuleNotFoundError v jazyku Python 3 pre príkaz pip v systémoch Windows, macOS a Linux pomocou nástroja ensurepip, balíkov operačného systému, virtuálnych prostredí a kontrol interpretov.
Opravte chybu „Oprávnenie GitHub SSH zamietnuté (verejný kľúč)“ kontrolou hostiteľa, aktívneho kľúča SSH, účtu GitHub, autorizácie SSO, vzdialenej adresy URL a prístupu na port 22.
Bezpečne opravte nerýchle pretáčanie zmien v Gite. Chráňte lokálnu prácu, načítajte vzdialené commity, vyberte zlúčenie alebo rebase, vyriešte konflikty a odošlite zmeny bez straty.
Opravte chyby Nginx 502 Bad Gateway s Node.js upstream kontrolou portu aplikácie, protokolov NGINX, adresy proxy_pass, siete kontajnerov, časových limitov a opätovného načítania.
Oprava chyby „Typ 'null' nie je možné priradiť k typu“ v jazyku TypeScript pomocou typov zjednotenia, zúženia, predvolených hodnôt a bezpečných tvrdení v rámci strictNullChecks.
Opravte chybu nevygenerovaného Prisma Client kontrolou generátora, schémy, výstupnej cesty, importov, verzií, nastavenia monorepa a krokov zostavenia pri nasadení.
Opravte chybu Node.js ERR_MODULE_NOT_FOUND v ESM kontrolou ciest importu, prípon súborov, inštalácie balíkov, exportov, režimu ESM a čistých inštalácií.
Vyriešte chybu Git 'unable to get local issuer certificate' identifikáciou dôveryhodného backendu, inštaláciou správneho reťazca CA a ponechaním zapnutej SSL verifikácie.
Opravte chyby časového limitu siete MongoDB v Mongoose identifikáciou typu časového limitu, testovaním dosiahnuteľnosti Atlasu alebo TCP, opravou URI a ladením časových limitov len v odôvodnených prípadoch.
