Ako Terminal vrati zsh: command not found: flutter, macOS vam govori da trenutna ljuska ne može pronaći program pod nazivom flutter u direktorijima navedenim u njezinom PATH. PATH je varijabla okruženja: popis mapa koje ljuska pretražuje kada upišete naredbu. Rješenje je obično jednostavno, ali vrijedi provjeriti lokaciju instalacije prije uređivanja bilo čega.
Za početnika cilj nije samo da jedan prozor Terminala prepozna Flutter jednom. Dobar rezultat je da novootvoreni prozor Terminala može pokrenuti flutter --version, dart --version i flutter doctor -v bez poruke "command not found". Vaš IDE također bi trebao prepoznati Flutter nakon ponovnog pokretanja.
Od rujna 2026., službena dokumentacija za instalaciju Fluttera odražava dokumentacijski skup Flutter 3.47.2. Upute za PATH na macOSu i dalje pretpostavljaju Appleovu zadanu ljusku, Zsh, i govore korisnicima da dodaju bin direktorij Flutter SDK-a u ~/.zprofile. Pogledajte Službene Flutter upute za PATH. Apple također potvrđuje da je Zsh zadana ljuska u Terminalu na trenutnim verzijama macOSa: Appleova dokumentacija o ljuskama u Terminalu.
Potrebne su vam dvije stvari: Flutter SDK koji stvarno postoji na disku i točna lokacija njegove bin mape. SDK, ili softverski razvoj kit, je zbirka Flutterovih alata naredbenog retka, biblioteka i pratećih datoteka. bin mapa unutar njega sadrži izvršnu naredbu koju Terminal mora pronaći.
Ako još niste instalirali Flutter, dodavanje nepostojeće mape u PATH neće pomoći. Prvo slijedite Flutterov vodič za ručnu instalaciju ili službenu rutu instalacije putem VS Codea. Trenutne macOS upute za Flutter sugeriraju lokaciju dostupnu za pisanje korisniku, kao što je ~/develop/, za ručno raspakirani SDK.
Otvorite Terminal i pokrenite:
flutter --versionAko vidite poruku poput zsh: command not found: flutter, potvrdite koju ljusku koristite:
echo $SHELLNa tipičnom trenutnom Macu, rezultat je /bin/zsh. Ako koristite Bash, Fish ili drugu ljusku, nemojte slijepo uređivati Zsh datoteke; datoteka za pokretanje specifična je za ljusku.
Zatim pronađite svoj Flutter SDK. Ako ste slijedili primjer ručne instalacije, provjerite:
ls "$HOME/develop/flutter/bin/flutter"Ako ta naredba ispiše putanju datoteke, SDK postoji i vjerojatni problem je PATH. Ako kaže da datoteka ne postoji, nemojte nastaviti s primjerom putanje. Prvo locirajte stvarnu Flutter mapu. Možete koristiti Finder ili pretražiti vjerojatne direktorije koje ste odabrali pri raspakiravanju SDK-a.
Flutterova dokumentacija za rješavanje problema također napominje da, ako je VS Code već konfiguriran za Flutter, Flutter ekstenzija može koristiti svoj upit Locate SDK za identifikaciju SDK mape. Pogledajte Flutterovo rješavanje problema s instalacijom.
Za zadanu Zsh konfiguraciju dokumentiranu od strane Fluttera na macOSu, otvorite ili kreirajte ~/.zprofile. Vodeća točka znači da je to skrivena konfiguracijska datoteka u vašoj početnoj mapi.
Možete je uređivati bilo kojim tekstualnim uređivačem. Iz Terminala, jednostavna opcija je:
nano ~/.zprofileDodajte ovu liniju, zamijenivši putanju ako je vaš SDK negdje drugdje:
export PATH="$HOME/develop/flutter/bin:$PATH"Ovo znači: stavite Flutterov bin direktorij na početak postojećeg PATH-a, a zatim zadržite sve direktorije koji su već bili tamo. Stavljanje Fluttera na prvo mjesto korisno je ako se druga zastarjela Flutter instalacija pojavi drugdje u PATH-u.
Spremite datoteku. U Nanu, pritisnite Control+O, pritisnite Return za potvrdu naziva datoteke, a zatim Control+X za izlaz.
~/.zprofile naredbu prikazanu u članku; prikazani uređivač je ilustrativan, a ne stvarni snimak zaslona.Možda ćete vidjeti starije tutorijale koji vam govore da uređujete ~/.zshrc. Ta datoteka može funkcionirati za interaktivnu Zsh konfiguraciju, ali Flutterova trenutna stranica za instalaciju na macOSu izričito nalaže korisnicima da unes PATH stave u ~/.zprofile. Za novu instalaciju, praćenje trenutne službene putanje izbjegava miješanje nekoliko konvencija datoteka za pokretanje.
Apple objašnjava važan razlog zašto je trajna konfiguracija važna: varijable okruženja postavljene u jednoj sesiji ljuske ne pojavljuju se automatski u drugim neovisnim Terminal sesijama, a privremene varijable nestaju kada se ta sesija zatvori. Trajne vrijednosti pripadaju u datoteku za pokretanje ljuske. Pogledajte Appleov vodič za varijable okruženja.
Flutterove macOS upute govore vam da zatvorite i ponovno otvorite sve otvorene Zsh sesije u aplikacijama terminala i IDE-ovima nakon promjene PATH-a. To je lako propustiti. Prozor terminala koji je već bio otvoren možda i dalje koristi staro okruženje.
Zatvorite i ponovno otvorite Terminal, a zatim pokrenite:
command -v flutter
flutter --version
dart --versioncommand -v flutter trebao bi ispisati putanju do Flutter izvršne datoteke, na primjer:
/Users/yourname/develop/flutter/bin/flutterNaredbe za verziju sada bi trebale vratiti informacije o verziji umjesto "command not found". Ne brinite ako se vaše točne brojeve verzija razlikuju od primjera koje vidite na internetu; Flutter izdanja se mijenjaju tijekom vremena.
flutter --version u novootvorenom terminalu kako biste potvrdili da je naredba sada dostupna.Ako Flutter radi u Terminalu, ali i dalje nedostaje u VS Codeu ili drugom IDE-u, potpuno zatvorite i ponovno otvorite taj IDE. Službena Flutter PATH stranica izričito uključuje IDE sesije u aplikacije koje bi trebale biti ponovno pokrenute nakon promjena okruženja.
Jednom kada flutter sam radi, PATH greška je riješena. Sljedeća naredba je:
flutter doctor -vflutter doctor provjerava ostatak vašeg razvojnog okruženja. Za rad na macOS desktopu ili iOS-u, može identificirati probleme povezane s Xcodeom i drugim alatima. Službeni Flutter vodič za postavljanje na macOSu preporučuje pokretanje flutter doctor -v, a zatim rješavanje svih prijavljenih zadataka prije ponovnog pokretanja. Pogledajte Flutterov vodič za postavljanje macOS razvoja.
Ovo razlikovanje je važno: ako flutter doctor radi i prijavljuje Xcode problem, više nemate problem "Flutter command not found". Ponovna promjena PATH-a neće popraviti nedostajuću Xcode licencu, konfiguraciju alata naredbenog retka, problem sa simulatorom ili drugu ovisnost alata.
| Što vidite | Što to obično znači | Što provjeriti sljedeće |
|---|---|---|
~/develop/flutter/bin/flutter ne postoji | Primjer putanje je pogrešan za vaš Mac, ili SDK nije instaliran/raspakiran tamo. | Locirajte stvarni SDK prije uređivanja PATH-a. |
Izvršna datoteka postoji, ali command -v flutter ne vraća ništa | Flutter bin direktorij nije u PATH-u koji je učitala ova ljuska. | Provjerite točnu liniju u ~/.zprofile, a zatim ponovno otvorite Terminal. |
| Flutter radi u jednom prozoru Terminala, ali ne u drugom | Sesije su pokrenute s različitim okruženjima ili konfiguracijama ljuske. | Zatvorite sve prozore Terminala i pokrenite novu sesiju; provjerite echo $SHELL. |
| Flutter radi u Terminalu, ali ne u IDE terminalu | IDE možda i dalje ima staro okruženje. | Potpuno zatvorite IDE i ponovno ga otvorite. |
flutter doctor -v radi, ali prijavljuje druge greške | PATH je već popravljen; druga Flutter ovisnost zahtijeva pažnju. | Slijedite specifičan izlaz doktora umjesto ponovne promjene PATH-a. |
.../flutter/bin, a ne samo .../flutter./Users/alex/develop/flutter neće postojati na Macu čiji su račun i instalacijski direktorij različiti.:$PATH kako biste zadržali postojeće direktorije sustava za naredbe.flutter --version radi, prijeđite na flutter doctor -v.Trenutna Flutter dokumentacija upozorava da se podrška za Intel-based Macove (x64) postupno ukida, dok Apple Silicon ostaje napredna Mac arhitektura. Ta promjena životnog ciklusa obično ne objašnjava osnovnu poruku zsh: command not found: flutter kada instalirana izvršna datoteka jednostavno nije u PATH-u. Ako ste na Intel Macu i naiđete na probleme s kompatibilnošću nakon popravka PATH-a, provjerite trenutnu stranicu podržanih platformi Fluttera i arhivu SDK-a prije odabira Flutter verzije.
Imate pouzdanu postavku kada novootvoreni prozor Terminala može pronaći Flutter bez ručnih naredbi, flutter --version i dart --version uspješno rade, vaš IDE prepoznaje SDK nakon ponovnog pokretanja, i flutter doctor -v radi dovoljno daleko da prijavi stvarno stanje vaših razvojnih lanaca alata.
Ako ti provjere prođu, prestanite mijenjati PATH. Sve preostale upozorenja treba rješavati kao zasebne probleme s postavkama. To održava proces rješavanja problema predvidivim i sprječava da funkcionalna konfiguracija ljuske postane kompliciranija nego što je potrebno.
Ispravite Tailwind CSS stilove koji se ne ažuriraju u Vite Reactu provjerom postavki Tailwind v4, CSS uvoza, otkrivanja izvora, dinamičkih klasa, HMR-a i zastarjelih predmemorija.
Ispravite ModuleNotFoundError u Pythonu 3 za pip na Windowsima, macOS-u i Linuxu pomoću ensurepipa, OS paketa, virtualnih okruženja i provjera interpretera.
Ispravite GitHub SSH Permission Denied (publickey) provjerom hosta, aktivnog SSH ključa, GitHub računa, SSO autorizacije, udaljenog URL-a i pristupa portu 22.
Sigurno ispravite Git push koji ne omogućuje brzo premotavanje. Zaštitite lokalni rad, dohvatite udaljene commitove, odaberite spajanje ili rebase, riješite sukobe i pushajte bez gubitka promjena.
Ispravite greške Nginx 502 Bad Gateway s Node.js uzvodno provjerom porta aplikacije, NGINX logova, proxy_pass adrese, umrežavanja kontejnera, vremenskih ograničenja i ponovnog učitavanja.
Ispravljena je greška "Tip 'null' nije moguće dodijeliti tipu" u TypeScriptu s tipovima unija, sužavanjem, zadanim vrijednostima i sigurnim tvrdnjama pod strictNullChecks.
Ispravite pogrešku da Prisma Client nije generiran provjerom generatora, sheme, izlazne putanje, uvoza, verzija, monorepo postavki i koraka izgradnje pri implementaciji.
Ispravite Node.js ERR_MODULE_NOT_FOUND u ESM-u provjerom putanja uvoza, ekstenzija datoteka, instalacije paketa, izvoza, ESM načina rada i čistih instalacija.
Riješite Gitovu grešku 'nemoguće dobiti lokalni certifikat izdavatelja' identificiranjem pozadine povjerenja, instaliranjem ispravnog lanca CA i održavanjem omogućene SSL verifikacije.
Riješite greške mrežnog isteka vremena MongoDB u Mongooseu identificiranjem vrste isteka, testiranjem dostupnosti Atlasa ili TCP-a, ispravljanjem URI-ja i podešavanjem vremena isteka samo kada je opravdano.
