Če Terminal vrne zsh: command not found: flutter, vam macOS sporoča, da trenutna lupina ne more najti programa z imenom flutter v imenikih, navedenih v spremenljivki PATH. PATH je okoljska spremenljivka: seznam map, ki jih lupina preišče, ko vtipkate ukaz. Popravek je običajno preprost, vendar je vredno preveriti lokacijo namestitve, preden karkoli urejate.
Za začetnika cilj ni le, da eno okno Terminala prepozna Flutter enkrat. Dober rezultat je, da lahko novo odprto okno Terminala zažene ukaze flutter --version, dart --version in flutter doctor -v brez sporočila “command not found”. Tudi vaš IDE bi moral prepoznati Flutter po ponovnem zagonu.
Septembra 2026 uradna dokumentacija za namestitev Flutterja odraža dokumentacijski nabor Flutter 3.47.2. Navodila za pot PATH na macOS še vedno predpostavljajo privzeto lupino Apple, Zsh, in uporabnikom svetujejo, da mapo bin SDK Flutter dodajo v ~/.zprofile. Glejte Uradna navodila Flutterja za pot PATH. Apple tudi potrjuje, da je Zsh privzeta lupina v Terminalu na trenutnih različicah macOS: Dokumentacija Apple Terminala o lupinah.
Potrebujete dve stvari: SDK Flutter, ki dejansko obstaja na disku, in natančno lokacijo njegove mape bin. SDK oziroma nabor orodij za razvoj programske opreme je zbirka ukaznih orodij Flutter, knjižnic in podpornih datotek. Mapa bin znotraj nje vsebuje izvršljivi ukaz, ki ga mora Terminal najti.
Če Flutterja še niste namestili, dodajanje neobstoječe mape v PATH ne bo pomagalo. Najprej sledite Ročnemu vodniku za namestitev Flutterja ali uradni poti namestitve prek VS Code. Trenutna navodila Flutterja za macOS predlagajo uporabniku zapisljivo lokacijo, kot je ~/develop/, za ročno razpakiran SDK.
Odprite Terminal in zaženite:
flutter --versionČe vidite sporočilo, kot je zsh: command not found: flutter, potrdite, katero lupino uporabljate:
echo $SHELLNa tipičnem sodobnem Macu je rezultat /bin/zsh. Če uporabljate Bash, Fish ali drugo lupino, ne urejajte slepo datotek Zsh; zagonska datoteka je specifična za lupino.
Nato poiščite svoj SDK Flutter. Če ste sledili primeru ročne namestitve, preverite:
ls "$HOME/develop/flutter/bin/flutter"Če ta ukaz izpiše pot do datoteke, SDK obstaja in verjetna težava je PATH. Če sporoči, da datoteka ne obstaja, ne nadaljujte s primerom poti. Najprej poiščite pravo mapo Flutter. Uporabite lahko Finder ali poiščite verjetne imenike, ki ste jih izbrali ob razpakiranju SDK.
Dokumentacija za odpravljanje težav Flutterja tudi opozarja, da je bil VS Code že konfiguriran za Flutter, razširitev Flutter lahko uporabi poziv Locate SDK za identifikacijo mape SDK. Glejte Odpravljanje težav pri namestitvi Flutterja.
Za privzeto nastavitev Zsh, dokumentirano s strani Flutterja na macOS, odprite ali ustvarite ~/.zprofile. Vodeča pika pomeni, da gre za skrito konfiguracijsko datoteko v vašem domačem imeniku.
Urejate jo lahko s katerimkoli urejevalnikom besedila. Iz Terminala je preprosta možnost:
nano ~/.zprofileDodajte to vrstico, pri čemer zamenjajte pot, če je vaš SDK nekje drugje:
export PATH="$HOME/develop/flutter/bin:$PATH"To pomeni: postavite mapo bin Flutterja na začetek obstoječe poti PATH, nato pa obdržite vse imenike, ki so bili že tam. Postavitev Flutterja na prvo mesto je koristna, če se drugje v PATH pojavi druga zastarela namestitev Flutterja.
Shranite datoteko. V Nano pritisnite Control+O, pritisnite Return za potrditev imena datoteke, nato pa Control+X za izhod.
~/.zprofile, prikazanemu v članku; prikazani urejevalnik je ilustrativen in ne dejanski posnetek zaslona.Morda boste zasledili starejše vodnike, ki vam svetujejo urejanje ~/.zshrc. Ta datoteka lahko deluje za interaktivno konfiguracijo Zsh, vendar trenutna stran za namestitev Flutterja na macOS izrecno navaja uporabnike, naj vnos PATH postavijo v ~/.zprofile. Pri novi namestitvi sledenje trenutni uradni poti preprečuje mešanje več konvencij zagonskih datotek.
Apple pojasnjuje pomemben razlog, zakaj je vztrajna konfiguracija pomembna: okoljske spremenljivke, nastavljene v eni seji lupine, se ne pojavijo samodejno v drugih neodvisnih sejah Terminala, začasne spremenljivke pa izginejo, ko se seja zapre. Trajne vrednosti spadajo v zagonsko datoteko lupine. Glejte Vodnik Apple o okoljskih spremenljivkah.
Navodila Flutterja za macOS vam svetujejo, da po spremembi PATH zaprete in znova odprete vse odprte seje Zsh v aplikacijah terminala in IDE. To je enostavno spregledati. Okno terminala, ki je bilo že odprto, morda še vedno uporablja staro okolje.
Zaprite in znova odprite Terminal, nato zaženite:
command -v flutter
flutter --version
dart --versioncommand -v flutter bi moral izpisati pot do izvršljive datoteke Flutter, na primer:
/Users/yourname/develop/flutter/bin/flutterUkazi za različico bi morali zdaj vrniti informacije o različici namesto “command not found”. Ne skrbite, če se vaše natančne številke različic razlikujejo od primerov, ki jih vidite na spletu; izdaje Flutterja se s časom spreminjajo.
flutter --version v novo odprtem terminalu, da potrdite, da je ukaz zdaj zaznaven.Če Flutter deluje v Terminalu, a je še vedno videti kot manjkajoč v VS Code ali drugem IDE, popolnoma zaprite in znova odprite ta IDE. Uradna stran Flutterja za PATH izrecno vključuje seje IDE med aplikacijami, ki jih je treba ponovno zagnati po spremembah okolja.
Ko flutter sam teče, je napaka PATH rešena. Naslednji ukaz je:
flutter doctor -vflutter doctor preveri preostanek vašega razvojnega okolja. Za namizni macOS ali delo z iOS lahko identificira težave, povezane z Xcode in drugimi orodji. Uradni vodnik Flutterja za nastavitev macOS priporoča zagon flutter doctor -v in nato reševanje vseh prijavljenih nalog, preden ga zaženete znova. Glejte Vodnik Flutterja za nastavitev razvoja na macOS.
Ta razlika je pomembna: če flutter doctor teče in poroča o težavi z Xcode, nimate več težave “Flutter command not found”. Ponovna sprememba PATH ne bo popravila manjkajoče licence Xcode, konfiguracije ukaznih orodij, težave s simulatorjem ali druge odvisnosti orodne verige.
| Kaj vidite | Kaj to običajno pomeni | Kaj preveriti naprej |
|---|---|---|
~/develop/flutter/bin/flutter ne obstaja | Primer poti je napačen za vaš Mac ali SDK ni bil nameščen/razpakiran tam. | Poiščite dejanski SDK, preden urejate PATH. |
Izvršljiva datoteka obstaja, a command -v flutter ne vrne ničesar | Mapa bin Flutter ni v poti PATH, ki jo naloži ta lupina. | Preverite natančno vrstico v ~/.zprofile, nato znova odprite Terminal. |
| Flutter deluje v enem oknu Terminala, ne pa v drugem | Seje so bile zagnane z različnimi okolji ali konfiguracijami lupine. | Zaprite vsa okna Terminala in začnite novo sejo; preverite echo $SHELL. |
| Flutter deluje v Terminalu, ne pa v terminalu IDE | IDE morda še vedno ima staro okolje. | Popolnoma zaprite IDE in ga znova odprite. |
flutter doctor -v teče, a poroča o drugih napakah | PATH je že popravljen; druga odvisnost Flutterja potrebuje pozornost. | Sledite specifičnemu izpisu doctorja, namesto da bi ponovno spreminjali PATH. |
.../flutter/bin, ne le .../flutter./Users/alex/develop/flutter ne bo obstajal na Macu, kjer sta račun in namestitveni imenik drugačna.:$PATH, da obdržite obstoječe sistemske imenike ukazov.flutter --version deluje, preidite na flutter doctor -v.Trenutna dokumentacija Flutterja opozarja, da se podpora za Mac z Intelovimi procesorji (x64) postopoma ukinja, medtem ko je Apple Silicon prihodnja arhitektura Mac. Ta sprememba življenjskega cikla običajno ne pojasnjuje osnovnega sporočila zsh: command not found: flutter, ko nameščena izvršljiva datoteka preprosto ni v PATH. Če ste na Intelovem Macu in naletite na težave s združljivostjo po popravilu PATH, preverite trenutno stran podprtih platform Flutterja in arhiv SDK, preden izberete različico Flutterja.
Zanesljivo nastavitev imate, ko novo okno Terminala najde Flutter brez ročnih ukazov, flutter --version in dart --version uspešno tečeta, vaš IDE prepozna SDK po ponovnem zagonu in flutter doctor -v teče dovolj daleč, da poroča o dejanskem stanju vaših razvojnih orodnih verig.
Če ti preveri uspejo, prenehajte spreminjati PATH. Morebitna preostala opozorila obravnavajte kot ločene težave pri nastavitvi. To ohranja postopek odpravljanja težav predvidljiv in preprečuje, da bi delujoča konfiguracija lupine postala bolj zapletena, kot je potrebno.
Odpravite napako Git 'unable to get local issuer certificate' z identifikacijo varnostnega ozadja, namestitvijo pravilnega veriga CA in ohranjanjem vklopljene SSL preverjanja.
Odpravite napake omrežnega časovnega prekoraka MongoDB v Mongoose z identifikacijo vrste časovnega prekoraka, testiranjem dosegljivosti Atlas ali TCP, popravkom URI in prilagajanjem časovnih omejitev le, ko je to upravičeno.
Odpravite napako izvajalne politike Restricted v PowerShellu tako, da preverite obseg in skupinsko politiko, nato izberete RemoteSigned, Unblock-File ali začasno možnost seje.
Odpravite konflikte odvisnosti vrstnikov npm ERESOLVE tako, da identificirate nezdružljiv razpon paketov, uskladite različice, uporabite ukaze npm explain in npm ls ter uporabljate legacy-peer-deps ali force le kot nadzorovane rezervne možnosti.
Odpravite napake zavrnjene povezave Redis na 127.0.0.1:6379 s preverjanjem strežnika, vrat, Docker omrežja, redis.conf, preverjanja pristnosti in TLS.
Odpravite napake 500 v strežniških komponentah Next.js tako, da sledite strežniškim dnevnikom, preverite pridobivanje podatkov in spremenljivke okolja, obravnavate napake ter preverite produkcijsko gradnjo.
Diagnostika in odpravljanje napake CrashLoopBackOff v Kubernetesu v lokalnem okolju Minikube s preverjanjem stanja poda, prejšnjih dnevnikov, razlogov za izhod, sond, konfiguracije, omejitev pomnilnika in zdravja klastra.
Popravite napako 'Engine stopped' v Docker Desktopu na Windows 11 s preverjanjem stanja Dockerja, posodobitvijo in ponovnim zagonom WSL 2, preverjanjem virtualizacije ter uporabo diagnostike pred ponastavitvijo.
Odpravite napako 'process is not defined' v Vite tako, da zamenjate uporabo process.env v slogu Node.js, pravilno konfigurirate spremenljivke VITE_ in preverite odvisnosti.
Odpravite napake PyTorch CUDA out-of-memory s praktičnim postopkom: izmerite pomnilnik GPU, zmanjšajte delovni nabor, uporabite AMP in akumulacijo, shranite aktivacije v kontrolne točke in prilagodite dodeljevalnik le, ko je to potrebno.
