Jei terminale matote pranešimą zsh: command not found: flutter, tai reiškia, kad macOS sistema praneša, jog esama aplinka (shell) negali rasti programos, pavadinimu flutter, kataloguose, nurodytuose jos PATH kintamajame. PATH yra aplinkos kintamasis: aplankų sąrašas, kuriuos aplinka ieško, kai įvedate komandą. Sprendimas dažniausiai yra paprastas, tačiau prieš redaguojant bet kokius failus verta patikrinti diegimo vietą.
Pradedančiajam tikslas yra ne tik priversti vieną terminalo langą vieną kartą atpažinti Flutter. Geras rezultatas yra toks, kad naujai atidarytame terminalo lange galima paleisti komandas flutter --version, dart --version ir flutter doctor -v be pranešimo „command not found“. Taip pat IDE turėtų atpažinti Flutter po paleidimo iš naujo.
2026 m. rugsėjo mėn. duomenimis, oficialioje Flutter diegimo dokumentacijoje pateikiama Flutter 3.47.2 dokumentų rinkinio informacija. macOS PATH instrukcijos vis dar remiasi „Apple“ numatytąja aplinka Zsh ir nurodo vartotojams pridėti Flutter SDK bin katalogą į failą ~/.zprofile. Žr. oficialias Flutter PATH instrukcijas. „Apple“ taip pat patvirtina, kad Zsh yra numatytoji aplinka terminale dabartinėse macOS versijose: „Apple“ terminalo aplinkos dokumentacija.
Jums reikia dviejų dalykų: Flutter SDK, kuris iš tikrųjų egzistuoja diske, ir tikslios jo bin aplanko vietos. SDK (programinės įrangos kūrimo rinkinys) yra Flutter komandinės eilutės įrankių, bibliotekų ir palaikomųjų failų rinkinys. Jame esančiame bin aplanke yra vykdomoji komanda, kurią terminalui reikia rasti.
Jei dar neįdiegėte Flutter, neegzistuojančio aplanko pridėjimas į PATH nepadės. Pirmiausia vadovaukitės oficialiu Flutter rankinio diegimo vadovu arba oficialiu VS Code diegimo būdu. Dabartinės Flutter macOS instrukcijos siūlo naudoti vartotojo rašymui tinkamą vietą, pvz., ~/develop/, rankiniu būdu išskleistam SDK.
Atidarykite terminalą ir paleiskite:
flutter --versionJei matote pranešimą, pvz., zsh: command not found: flutter, patikrinkite, kurią aplinką naudojate:
echo $SHELLTipiškame dabartiniame „Mac“ rezultatas yra /bin/zsh. Jei naudojate Bash, Fish ar kitą aplinką, neaklai redaguokite Zsh failus; paleidimo failas priklauso nuo konkrečios aplinkos.
Toliau suraskite savo Flutter SDK. Jei vadovavotės rankinio diegimo pavyzdžiu, patikrinkite:
ls "$HOME/develop/flutter/bin/flutter"Jei ši komanda atspausdina failo kelią, SDK egzistuoja ir tikėtina problema yra PATH. Jei nurodoma, kad failas neegzistuoja, nesinaudokite pavyzdiniu keliu. Pirmiausia suraskite tikrąjį Flutter aplanką. Galite naudoti „Finder“ arba ieškoti tikėtinuose kataloguose, kuriuos pasirinkote išskleisdami SDK.
Flutter trikčių šalinimo dokumentacijoje taip pat nurodoma, kad jei VS Code jau buvo sukonfigūruotas Flutter, Flutter plėtinys gali naudoti savo Locate SDK užklausą, kad nustatytų SDK aplanką. Žr. Flutter diegimo trikčių šalinimą.
Numatytajai Zsh sąrankai, dokumentuotai Flutter macOS sistemoje, atidarykite arba sukurkite failą ~/.zprofile. Pradinis taškas reiškia, kad tai paslėptas konfigūracinis failas jūsų namų kataloge.
Jį galite redaguoti bet kuriuo teksto redaktoriumi. Iš terminalo paprastas variantas yra:
nano ~/.zprofilePridėkite šią eilutę, pakeisdami kelią, jei jūsų SDK yra kitoje vietoje:
export PATH="$HOME/develop/flutter/bin:$PATH"Tai reiškia: į esamo PATH pradžią įdėkite Flutter bin katalogą, o tada palikite visus jau buvusius katalogus. Flutter įdėjimas į priekį yra naudingas, jei kitas pasenusios Flutter diegties kopija atsiranda kitur PATH kintamajame.
Išsaugokite failą. Nano redaktoriuje paspauskite Control+O, paspauskite Enter, kad patvirtintumėte failo pavadinimą, o tada Control+X, kad išeitumėte.
~/.zprofile komandą; pavaizduotas redaktorius yra iliustracinis, o ne tikras ekrano nuotrauka.Galite pamatyti senesnes pamokas, kuriose siūloma redaguoti ~/.zshrc. Šis failas gali veikti interaktyviai Zsh konfigūracijai, tačiau dabartinis Flutter macOS diegimo puslapis konkrečiai nurodo vartotojams PATH įrašą dėti į ~/.zprofile. Naujam diegimui sekant dabartinį oficialų kelią išvengiama kelių paleidimo failų konvencijų maišymo.
„Apple“ paaiškina svarbią priežastį, kodėl nuolatinė konfigūracija yra svarbi: aplinkos kintamieji, nustatyti vienoje aplinkos sesijoje, automatiškai neatsiranda kitose nepriklausomose terminalo sesijose, o laikinieji kintamieji išnyksta uždarant tą sesiją. Nuolatinės reikšmės turi būti paleidimo failuose. Žr. „Apple“ aplinkos kintamųjų vadovą.
Flutter macOS instrukcijos nurodo uždaryti ir iš naujo atidaryti visas atidarytas Zsh sesijas terminalo programose ir IDE po PATH pakeitimo. Tai lengva praleisti. Jau atidarytas terminalo langas gali vis dar naudoti seną aplinką.
Išjunkite ir iš naujo atidarykite terminalą, tada paleiskite:
command -v flutter
flutter --version
dart --versionKomanda command -v flutter turėtų atspausdinti kelią iki Flutter vykdomojo failo, pvz.:
/Users/yourname/develop/flutter/bin/flutterVersionų komandos dabar turėtų grąžinti versijos informaciją, o ne „command not found“. Nesijaudinkite, jei jūsų tikslios versijos numeriai skiriasi nuo pavyzdžių, kuriuos matote internete; Flutter versijos laikui bėgant keičiasi.
flutter --version naujai atidarytame terminale, kad patvirtintumėte, jog komanda dabar yra randama.Jei Flutter veikia terminale, bet vis tiek nematomas VS Code ar kitoje IDE, visiškai uždarykite ir iš naujo atidarykite tą IDE. Oficialiame Flutter PATH puslapyje aiškiai nurodoma, kad IDE sesijos taip pat turi būti paleistos iš naujo po aplinkos pakeitimų.
Kai pati flutter komanda veikia, PATH klaida yra išspręsta. Kita komanda yra:
flutter doctor -vflutter doctor patikrina likusią jūsų kūrimo aplinkos dalį. macOS darbalaukio arba iOS darbams ji gali identifikuoti su Xcode ir kitais įrankiais susijusias problemas. Oficialiame Flutter macOS sąrankos vadove rekomenduojama paleisti flutter doctor -v ir išspręsti visas praneštas užduotis prieš paleidžiant jį dar kartą. Žr. Flutter macOS kūrimo sąrankos vadovą.
Šis skirtumas yra svarbus: jei flutter doctor veikia ir praneša apie Xcode problemą, jūs nebeturite „Flutter command not found“ problemos. Pakartotinis PATH keitimas neišspręs trūkstamos Xcode licencijos, komandinės eilutės įrankių konfigūracijos, simuliacijos problemos ar kitos įrankių grandinės priklausomybės.
| Ką matote | Ką tai paprastai reiškia | Ką tikrinti toliau |
|---|---|---|
~/develop/flutter/bin/flutter neegzistuoja | Pavyzdinis kelias jūsų „Mac“ neteisingas arba SDK nebuvo įdiegtas/išskleistas ten. | Prieš redaguodami PATH, suraskite tikrąjį SDK. |
Vykdomasis failas egzistuoja, bet command -v flutter nieko negrąžina | Flutter bin katalogas nėra PATH, kurį įkėlė ši aplinka. | Patikrinkite tikslią eilutę ~/.zprofile, tada iš naujo atidarykite terminalą. |
| Flutter veikia viename terminalo lange, bet ne kitame | Sesijos buvo paleistos su skirtingomis aplinkomis arba aplinkos konfigūracijomis. | Uždarykite visus terminalo langus ir pradėkite naują sesiją; patikrinkite echo $SHELL. |
| Flutter veikia terminale, bet ne IDE terminale | IDE gali vis dar turėti seną aplinką. | Visiškai uždarykite IDE ir iš naujo jį atidarykite. |
flutter doctor -v veikia, bet praneša apie kitas klaidas | PATH jau sutvarkytas; kitai Flutter priklausomybei reikia dėmesio. | Vadovaukitės konkrečiu doctor išvesties pranešimu vietoj pakartotinio PATH keitimo. |
.../flutter/bin, o ne tik .../flutter./Users/alex/develop/flutter neegzistuos „Mac“ kompiuteryje, kurio paskyra ir diegimo katalogas yra kitokie.:$PATH, kad išlaikytumėte esamus sistemos komandų katalogus.flutter --version veikia, pereikite prie flutter doctor -v.Dabartinė Flutter dokumentacija įspėja, kad palaikymas Intel pagrįstiems „Mac“ kompiuteriams (x64) yra palaipsniui nutraukiamas, o Apple Silicon lieka perspektyviausia „Mac“ architektūra. Šis gyvavimo ciklo pokytis paprastai nepaaiškina pagrindinio zsh: command not found: flutter pranešimo, kai įdiegtas vykdomasis failas tiesiog nėra PATH. Jei naudojate Intel „Mac“ ir susiduriate su suderinamumo problemomis po PATH sutvarkymo, prieš pasirinkdami Flutter versiją patikrinkite dabartinį Flutter palaikomų platformų puslapį ir SDK archyvą.
Turite patikimą sąranką, kai visiškai naujas terminalo langas gali rasti Flutter be rankinių komandų, flutter --version ir dart --version sėkmingai veikia, jūsų IDE atpažįsta SDK po paleidimo iš naujo, o flutter doctor -v veikia pakankamai toli, kad praneštų apie tikrąją jūsų kūrimo įrankių grandinės būseną.
Jei šie patikrinimai praeina, nustokite keisti PATH. Bet kokius likusius įspėjimus reikia spręsti kaip atskiras sąrankos problemas. Tai palaiko nuspėjamą trikčių šalinimo procesą ir neleidžia veikiančiai aplinkos konfigūracijai tapti nereikalingai sudėtingai.
Ištaisykite „Prisma Client“ nesugeneravimo klaidą patikrinę generatorių, schemą, išvesties kelią, importus, versijas, monorepo sąranką ir diegimo kūrimo veiksmus.
Ištaisykite Git klaidą „unable to get local issuer certificate“ nustatydami pasitikėjimo šaltinį, įdiegdami tinkamą CA grandinę ir palikdami įjungtą SSL patikrą.
Ištaisykite MongoDB tinklo laiko limito klaidas Mongoose nustatydami laiko limito tipą, patikrindami Atlas arba TCP pasiekiamumą, koreguodami URI ir tikslindami laiko limitus tik tada, kai tai pagrįsta.
Ištaisykite PowerShell vykdymo politikos „Restricted“ klaidą patikrindami sritį ir grupės politiką, tada pasirinkdami RemoteSigned, Unblock-File arba laikiną sesijos parinktį.
Ištaisykite npm ERESOLVE peer dependency konfliktus nustatydami nesuderinamą paketo diapazoną, suderindami versijas, naudodami komandas npm explain ir npm ls, bei laikydami legacy-peer-deps arba force tik kontroliuojamais atsarginiais variantais.
Ištaisykite Redis prisijungimo atmetimo klaidas adresu 127.0.0.1:6379 tikrindami serverį, prievadą, Docker tinklą, redis.conf, autentifikaciją ir TLS.
Ištaisykite Next.js Server Component 500 klaidas stebėdami serverio žurnalus, tikrindami duomenų gavimą ir aplinkos kintamuosius, apdorodami klaidas ir patikrindami gamybinį sukūrimą.
Diagnozuokite ir ištaisykite Kubernetes CrashLoopBackOff klaidą vietiniame Minikube tikrindami pod būseną, ankstesnius žurnalus, išėjimo priežastis, zondas, konfigūraciją, atminties apribojimus ir klasterio sveikatą.
Ištaisykite „Docker Desktop Engine Stopped“ klaidą sistemoje Windows 11 tikrindami Docker būseną, atnaujindami ir paleisdami iš naujo WSL 2, tikrindami virtualizaciją bei naudodami diagnostiką prieš atstatymą.
Ištaisykite Vite klaidą „process is not defined“ pakeisdami Node stiliaus process.env naudojimą, teisingai sukonfigūruodami VITE_ kintamuosius ir patikrindami priklausomybes.
