Ef Terminal skilar zsh: command not found: flutter segir macOS þér að núverandi skel finni ekki forrit sem heitir flutter í möppunum sem eru skráðar í PATH. PATH er umhverfisbreyta: listi yfir möppur sem skelin leitar í þegar þú slærð inn skipun. Lagfæringin er yfirleitt einföld, en það er vert að athuga uppsetningarstaðinn áður en eitthvað er breytt.
Fyrir byrjendur er markmiðið ekki bara að láta eitt Terminal-glugga þekkja Flutter einu sinni. Góður árangur er að nýopnað Terminal-glugga geti keyrt flutter --version, dart --version og flutter doctor -v án skilaboðanna “command not found”. IDE-ið þitt ætti einnig að þekkja Flutter eftir að það hefur verið endurræst.
Í september 2026 endurspeglar opinber uppsetningarskjöl Flutter skjölunarsafn Flutter 3.47.2. Leiðbeiningarnar um PATH á macOS gera enn ráð fyrir sjálfgefna skel Apple, Zsh, og segja notendum að bæta bin-möppu Flutter SDK við ~/.zprofile. Sjá opinberar PATH-leiðbeiningar Flutter. Apple staðfestir einnig að Zsh sé sjálfgefna skelin í Terminal á núverandi macOS útgáfum: Apple Terminal skel skjölun.
Þú þarft tvo hluti: Flutter SDK sem er til staðar á diski, og nákvæman staðsetningu á bin-möppu þess. SDK, eða hugbúnaðarþróunarsafn, er safn af Flutter skipanalínutólum, söfnum og stuðningsskrám. bin-mappan inniheldur keyranlegu skipunina sem Terminal þarf að finna.
Ef þú hefur ekki sett upp Flutter ennþá, mun það að bæta við möppu sem er ekki til í PATH ekki hjálpa. Fylgdu handbók Flutter fyrir handvirka uppsetningu eða opinberri VS Code uppsetningarleið fyrst. Núverandi macOS leiðbeiningar Flutter mæla með notendaskrifanlegri staðsetningu eins og ~/develop/ fyrir handvirkt afpakkað SDK.
Opnaðu Terminal og keyrðu:
flutter --versionEf þú sérð skilaboð eins og zsh: command not found: flutter, staðfestu hvaða skel þú ert að nota:
echo $SHELLÁ venjulegum nýjum Mac er niðurstaðan /bin/zsh. Ef þú notar Bash, Fish eða aðra skel, ekki blindlega breyta Zsh skrár; upphafsskráin er skelspecifik.
Næst, finndu Flutter SDK þitt. Ef þú fylgdir dæminu um handvirka uppsetningu, athugaðu:
ls "$HOME/develop/flutter/bin/flutter"Ef þessi skipun prentar skráarslóðina, er SDK-ið til og líklegasta vandamálið er PATH. Ef það segir að skráin sé ekki til, haltu ekki áfram með dæmislóðina. Finndu raunverulegu Flutter möppuna fyrst. Þú getur notað Finder, eða leitað í líklegum möppum sem þú valdir þegar þú afpakkaðir SDK-ið.
Leiðbeiningar Flutter um villusögn minna einnig á að ef VS Code hefur þegar verið stillt fyrir Flutter, getur Flutter viðbótin notað Locate SDK spurningu til að auðkenna SDK möppuna. Sjá Flutter uppsetningar villusögn.
Fyrir sjálfgefna Zsh uppsetningu sem Flutter skráir á macOS, opnaðu eða búðu til ~/.zprofile. Fremsti punkturinn þýðir að þetta er falin stillingarskrá í heimapönnu þinni.
Þú getur breytt henni með hvaða textaritli sem er. Frá Terminal, einfalt valkostur er:
nano ~/.zprofileBættu við þessari línu, skiptu um slóð ef SDK-ið þitt er einhvers staðar annars staðar:
export PATH="$HOME/develop/flutter/bin:$PATH"Þetta segir: settu bin-möppu Flutter fremst í núverandi PATH, og haltu síðan öllum möppunum sem voru þegar til staðar. Að setja Flutter fremst er gagnlegt ef önnur gömul Flutter uppsetning birtist annars staðar í PATH.
Vistaðu skrána. Í Nano, ýttu á Control+O, ýttu á Return til að staðfesta skráarnafnið, og síðan Control+X til að fara út.
~/.zprofile skipuninni sem sýnd er í greininni; myndskreytingin af ritlinum er til skýringar en ekki raunveruleg skjámynd.Þú gætir séð eldri leiðbeiningar segja þér að breyta ~/.zshrc. Sú skrá getur virkað fyrir gagnvirka Zsh stillingar, en núverandi macOS uppsetningarsíða Flutter segir sérstaklega notendum að setja PATH færsluna í ~/.zprofile. Fyrir nýja uppsetningu, að fylgja núverandi opinberri leið forðast blöndu af mörgum upphafsskrá venjum.
Apple útskýrir mikilvægan ástæðu fyrir því að varanlegar stillingar skipti máli: umhverfisbreytur sem stilltar eru í einni skelsetningu birtast ekki sjálfkrafa í öðrum óháðum Terminal setningum, og tímabundnar breytur hverfa þegar sú setning lokar. Varanleg gildi eiga heima í skel upphafsskrá. Sjá Apple umhverfisbreyta leiðbeiningar.
macOS leiðbeiningar Flutter segja þér að loka og enduropna öllum opnum Zsh setningum í terminal forritum og IDE-um eftir að PATH hefur verið breytt. Þetta er auðvelt að gleyma. Terminal gluggi sem var þegar opinn gæti enn að nota gömlu umhverfið.
Hættu og enduropnaðu Terminal, keyrðu síðan:
command -v flutter
flutter --version
dart --versioncommand -v flutter ætti að prenta slóðina á Flutter keyranlegu skrána, til dæmis:
/Users/yourname/develop/flutter/bin/flutterÚtgáfu skipanirnar ættu nú að skila upplýsingum um útgáfu frekar en “command not found”. Ekki hafa áhyggjur ef nákvæmar útgáfunúmer þínar eru önnur en dæmin sem þú sérð á netinu; Flutter útgáfur breytast með tímanum.
flutter --version í nýopnuðum terminal til að staðfesta að skipunin sé nú finnanleg.Ef Flutter virkar í Terminal en virðist enn vanta í VS Code eða öðru IDE, hættu alveg og enduropnaðu það IDE. Opinbera Flutter PATH síðan tekur sérstaklega til IDE setninga í forritunum sem ætti að endurræsa eftir að umhverfið breytist.
Þegar flutter sjálft keyrir, er PATH villan leyst. Næsta skipun er:
flutter doctor -vflutter doctor athugar restina af þróunarumhverfinu þínu. Fyrir macOS skjáborðs eða iOS vinnu, getur það auðkennt vandamál tengd Xcode og öðrum tólum. Opinber macOS uppsetningarleið Flutter mælir með að keyra flutter doctor -v og leysa síðan öll tilkynnt verkefni áður en hún er keyrð aftur. Sjá Flutter macOS þróunaruppsetningarleið.
Þessi greinarmunur skiptir máli: ef flutter doctor keyrir og tilkynnir Xcode vandamál, ertu ekki lengur með “Flutter command not found” vandamál. Að breyta PATH aftur mun ekki laga vantar Xcode leyfi, skipanalínu tól stillingu, hermunar vandamál eða aðra tólkeðju háð.
| Hvað þú sérð | Hvað það þýðir yfirleitt | Hvað á að athuga næst |
|---|---|---|
~/develop/flutter/bin/flutter er ekki til | Dæmislóðin er röng fyrir Mac-ið þitt, eða SDK-ið var ekki sett upp/afpakkað þar. | Finndu raunverulega SDK áður en þú breytir PATH. |
Keyranlega skráin er til, en command -v flutter skilar engu | Flutter bin möppan er ekki í PATH sem þessi skel hleður. | Athugaðu nákvæmu línuna í ~/.zprofile, og enduropnaðu síðan Terminal. |
| Flutter virkar í einu Terminal glugga en ekki öðru | Setningarnar voru hafnar með ólíkum umhverfum eða skel stillingum. | Lokaðu öllum Terminal gluggum og hafðu nýja setningu; staðfestu echo $SHELL. |
| Flutter virkar í Terminal en ekki í IDE terminal | IDE-ið gæti enn að hafa gamla umhverfið. | Hættu alveg við IDE-ið og enduropnaðu það. |
flutter doctor -v keyrir en tilkynnir aðrar villur | PATH er þegar lagað; önnur Flutter háð þarf athygli. | Fylgdu sérstökum doctor niðurstöðum í stað þess að breyta PATH aftur. |
.../flutter/bin, ekki bara .../flutter./Users/alex/develop/flutter verður ekki til á Mac þar sem reikningurinn og uppsetningarmappan eru önnur.:$PATH svo þú haldir núverandi skipunarmöppum kerfisins.flutter --version virkar, haltu áfram með flutter doctor -v.Núverandi skjölun Flutter varar við að stuðningur við Intel-bundna Macs (x64) sé í útrýmingu, á meðan Apple Silicon er framtíðar Mac arkitektúr. Þessi lífsferilsbreyting útskýrir yfirleitt ekki grunn zsh: command not found: flutter skilaboð þegar uppsett keyranleg skrá er einfaldlega ekki í PATH. Ef þú ert á Intel Mac og lendir í samhæfnisvandamálum eftir að PATH er lagað, athugaðu núverandi Flutter stuðningsplötform síðu og SDK safn áður en þú velur Flutter útgáfu.
Þú ert með áreiðanlega uppsetningu þegar nýtt Terminal glugga finnur Flutter án handvirka skipana, flutter --version og dart --version keyra vel, IDE-ið þitt þekkir SDK-ið eftir endurræsingu, og flutter doctor -v keyrir nógu langt til að tilkynna raunverulegt ástand þróunar tólkeðjunnar.
Ef þessar athuganir ganga, hættu að breyta PATH. Önnur varanir ættu að vera meðhöndlaðar sem sérstök uppsetningarvandamál. Það heldur villusögnarferlinu spáanlegu og kemur í veg fyrir að virk skel stilling verði flóknari en nauðsyn krefur.
Lagaðu Git-villuna „get ekki fengið staðvært útgefandavottorð“ með því að auðkenna traustbakendann, setja upp rétta CA-keðju og halda SSL-staðfestingu virkri.
Lagaðu MongoDB net-tímamótavillur í Mongoose með því að auðkenna tegund tímamóts, prófa aðgengi við Atlas eða TCP, leiðrétta URI og stilla tímamót aðeins þegar rétt er.
Lagaðu PowerShell execution policy Restricted villuna með því að athenda umfang og Group Policy, og velja síðan RemoteSigned, Unblock-File eða tímabundna valkost fyrir setu.
Lagaðu npm ERESOLVE peer dependency conflicts með því að auðkenna ósamhæfða pakkaröð, stilla útgáfur, nota npm explain og npm ls, og meðhöndla legacy-peer-deps eða force eingöngu sem stýrðar varalausnir.
Lagaðu villur þar sem Redis-tenging er hafnað á 127.0.0.1:6379 með því að athuga netþjóninn, port, Docker-netkerfi, redis.conf, auðkenningu og TLS.
Lagaðu 500-villur í Next.js Server Components með því að rekja server-logga, athuga gagnainnsóknir og umhverfisbreytur, meðhöndla villur og staðfesta framleiðslubygginguna.
Greinið og lagaðu Kubernetes CrashLoopBackOff í staðbundnu Minikube með því að athuga ástand poods, fyrri atvikaskrár, útgáfurök, prófanir, stillingar, minnisþak og heilsufar klusters.
Lagaðu Docker Desktop Engine Stopped á Windows 11 með því að athuga Docker stöðu, uppfæra og endurræsa WSL 2, staðfesta sýndarvæðingu og nota greiningu áður en núllstilling er framkvæmd.
Lagaðu villuna „process is not defined“ í Vite með því að skipta út Node-stíls notkun á process.env, stilla VITE_ breytur rétt og athuga háðir.
Lagaðu PyTorch CUDA minnisvillur með gagnlegri vinnuaðferð: mæltu GPU-minni, minnkaðu virka vinnusett, notaðu AMP og safnaðarstuðla, geymdu virkjunarpunkta og stilltu minnisstýringu aðeins ef þörf krefur.
