Jos Terminal palauttaa virheen zsh: command not found: flutter, macOS kertoo sinulle, että nykyinen shell ei löydä ohjelmaa nimeltä flutter sen PATH-muuttujassa luetelluista hakemistoista. PATH on ympäristömuuttuja: luettelo kansioista, joita shell etsii, kun kirjoitat komennon. Korjaus on yleensä suoraviivainen, mutta kannattaa tarkistaa asennuksen sijainti ennen minkään muokkaamista.
Aloittelijalle tavoite ei ole vain saada yksi Terminal-ikkuna tunnistamaan Flutter kerran. Hyvä tulos on, että vastoin avattu Terminal-ikkuna voi suorittaa komennot flutter --version, dart --version ja flutter doctor -v ilman “command not found” -viestiä. IDE:n tulisi myös tunnistaa Flutter uudelleenkäynnistyksen jälkeen.
September 2026 -tilanteen mukaan Flutterin virallinen asennusdokumentaatio heijastaa Flutter 3.47.2 -dokumentaatiojoukkoa. macOS:n PATH-ohjeet olettavat edelleen Applen oletusshellin, Zsh:n, ja ohjeistavat käyttäjiä lisäämään Flutter SDK:n bin-hakemiston tiedostoon ~/.zprofile. Katso Flutterin viralliset PATH-ohjeet. Apple vahvistaa myös, että Zsh on oletusshell Terminalissa nykyisissä macOS-versioissa: Applen Terminal-shell-dokumentaatio.
Tarvitset kaksi asiaa: levyllä todella olevan Flutter SDK:n ja sen bin-kansion tarkan sijainnin. SDK (software development kit) on kokoelma Flutterin komentorivityökaluja, kirjastoja ja tukitiedostoja. Sen sisällä oleva bin-kansio sisältää suoritettavan komennon, jonka Terminalin on löydettävä.
Et ole vielä asentanut Flutteria, olemattoman kansion lisääminen PATH-muuttujaan ei auta. Noudata ensin Flutterin manuaalista asennusopasta tai virallista VS Code -asennustapaa. Flutterin nykyiset macOS-ohjeet ehdottavat käyttäjän kirjoitettavissa olevaa sijaintia, kuten ~/develop/, manuaalisesti puretulle SDK:lle.
Avaa Terminal ja suorita:
flutter --versionJos näet viestin, kuten zsh: command not found: flutter, varmista, mitä shelliä käytät:
echo $SHELLTyypillisessä nykyisessä Macissa tulos on /bin/zsh. Jos käytät Bashia, Fishiä tai toista shelliä, älä sokeasti muokkaa Zsh-tiedostoja; käynnistystiedosto on shell-kohtainen.
Etsi seuraavaksi Flutter SDK:si. Jos noudatit manuaalisen asennuksen esimerkkiä, tarkista:
ls "$HOME/develop/flutter/bin/flutter"Jos komento tulostaa tiedoston polun, SDK on olemassa ja todennäköinen ongelma on PATH. Jos se ilmoittaa tiedoston puuttuvan, älä jatka esimerkkien polulla. Etsi ensin oikea Flutter-kansio. Voit käyttää Finderia tai etsiä todennäköisiä hakemistoja, jotka valitsit SDK:n purkamisen yhteydessä.
Flutterin vianmääritysdokumentaatio huomauttaa myös, että jos VS Code on jo määritetty Flutteria varten, Flutter-laajennus voi käyttää sen Locate SDK -kehote-ikkunaa SDK-kansion tunnistamiseen. Katso Flutter-asennuksen vianmääritys.
Flutterin macOS:lle dokumentoimassa oletus-Zsh-määrityksessä avaa tai luo tiedosto ~/.zprofile. Alkuperäpiste tarkoittaa, että se on piilotettu konfiguraatiotiedosto kotihakemistossasi.
Voit muokata sitä millä tahansa tekstieditorilla. Terminalista yksinkertainen vaihtoehto on:
nano ~/.zprofileLisää tämä rivi, korvaa polku, jos SDK:si on jossain muualla:
export PATH="$HOME/develop/flutter/bin:$PATH"Tämä tarkoittaa: laita Flutterin bin-hakemisto olemassa olevan PATH:n eteen, ja pidä kaikki jo siellä olevat hakemistot. Flutterin laittaminen eteen on hyödyllistä, jos toinen vanhentunut Flutter-asennus esiintyy muualla PATH:ssa.
Tallenna tiedosto. Nanossa paina Control+O, paina Return vahvistaaksesi tiedostonimen ja sitten Control+X poistuaksesi.
~/.zprofile-komentoa, joka näkyy artikkelissa; kuvattu editori on havainnollistava eikä oikea kuvakaappaus.Voit nähdä vanhempien opastusten kehottavan muokkaamaan tiedostoa ~/.zshrc. Tämä tiedosto voi toimia interaktiiviselle Zsh-konfiguraatiolle, mutta Flutterin nykyinen macOS-asennussivu ohjeistaa käyttäjiä sijoittamaan PATH-merkinnän nimenomaan tiedostoon ~/.zprofile. Uudessa asennuksessa nykyisen virallisen polun noudattaminen välttää useiden käynnistystiedostokäytäntöjen sekoittamisen.
Apple selittää tärkeän syyn, miksi pysyvä konfiguraatio on tärkeä: yhdessä shell-istunnossa asetetut ympäristömuuttujat eivät automaattisesti näy muissa itsenäisissä Terminal-istunnoissa, ja väliaikaiset muuttujat katoavat, kun istunto suljetaan. Pysyvät arvot kuuluvat shellin käynnistystiedostoon. Katso Applen ympäristömuuttujaopas.
Flutterin macOS-ohjeet kehottavat sulkemaan ja avaamaan uudelleen kaikki avoimet Zsh-istunnot terminaalisovelluksissa ja IDE:ssä PATH:n muuttamisen jälkeen. Tämä on helppo unohtaa. Jo avoinna ollut terminaali-ikkuna saattaa edelleen käyttää vanhaa ympäristöä.
Sulje ja avaa Terminal uudelleen, ja suorita sitten:
command -v flutter
flutter --version
dart --versioncommand -v flutter -komennon tulisi tulostaa polku Flutterin suoritettavaan tiedostoon, esimerkiksi:
/Users/yourname/develop/flutter/bin/flutterVersiotietokomentojen tulisi nyt palauttaa versiotietoja “command not found” -viestin sijaan. Älä huoli, jos tarkat versionumerosi poikkeavat verkossa näkemistäsi esimerkeistä; Flutter-julkaisut muuttuvat ajan myötä.
flutter --version uudessa terminaali-ikkunassa varmistaaksesi, että komento on nyt löydettävissä.Jos Flutter toimii Terminalissa, mutta näyttää puuttuvan VS Code:sta tai toisesta IDE:stä, sulje ja avaa kyseinen IDE kokonaan uudelleen. Virallinen Flutter PATH -sivu sisällyttää nimenomaisesti IDE-istunnot sovelluksiin, jotka tulisi käynnistää uudelleen ympäristön muutosten jälkeen.
Kun flutter itsessään toimii, PATH-virhe on ratkaistu. Seuraava komento on:
flutter doctor -vflutter doctor tarkistaa kehitysympäristösi loput osat. macOS-työpöytä- tai iOS-kehitykselle se voi tunnistaa Xcodeen ja muihin työkaluihin liittyviä ongelmia. Flutterin virallinen macOS-asennusopas suosittelee suorittamaan flutter doctor -v ja ratkaisemaan sitten kaikki ilmoitetut tehtävät ennen sen uudelleensuorittamista. Katso Flutterin macOS-kehityksen asennusopas.
Tämä erottelu on tärkeä: jos flutter doctor toimii ja ilmoittaa Xcode-ongelmasta, sinulla ei enää ole “Flutter command not found” -ongelmaa. PATH:n muuttaminen uudelleen ei korjaa puuttuvaa Xcode-lisenssiä, komentorivityökalujen konfiguraatiota, simulaattoriongelmaa tai muita työkaluketjun riippuvuuksia.
| Mitä näet | Mitä se yleensä tarkoittaa | Mitä tarkistaa seuraavaksi |
|---|---|---|
~/develop/flutter/bin/flutter ei ole olemassa | Esimerkkipolku on väärä Macillesi, tai SDK:ta ei asennettu/purettu sinne. | Etsi todellinen SDK ennen PATH:n muokkaamista. |
Suoritettava tiedosto on olemassa, mutta command -v flutter ei palauta mitään | Flutterin bin-hakemisto ei ole tämän shellin lataamassa PATH:ssa. | Tarkista tarkka rivi tiedostossa ~/.zprofile, ja avaa Terminal uudelleen. |
| Flutter toimii yhdessä Terminal-ikkunassa, mutta ei toisessa | Istunnot käynnistettiin eri ympäristöillä tai shell-konfiguraatioilla. | Sulje kaikki Terminal-ikkunat ja aloita uusi istunto; varmista echo $SHELL. |
| Flutter toimii Terminalissa, mutta ei IDE:n terminaalin | IDE:llä saattaa edelleen olla vanha ympäristö. | Sulje IDE kokonaan ja avaa se uudelleen. |
flutter doctor -v toimii, mutta ilmoittaa muista virheistä | PATH on jo korjattu; toinen Flutter-riippuvuus vaatii huomiota. | Noudata tarkkaa doctor-tulostetta PATH:n muuttamisen sijaan. |
.../flutter/bin, ei vain .../flutter./Users/alex/develop/flutter ei ole olemassa Macissa, jonka tili ja asennushakemisto ovat erilaiset.:$PATH, jotta pidät järjestelmän olemassa olevat komentojen hakemistot.flutter --version toimii, siirry komentoon flutter doctor -v.Flutterin nykyinen dokumentaatio varoittaa, että tuki Intel-pohjaisille Macille (x64) on vaiheittain poistumassa, kun taas Apple Silicon on tulevaisuuteen suuntautuva Mac-arkkitehtuuri. Tämä elinkaaren muutos ei yleensä selitä perusviestiä zsh: command not found: flutter, kun asennettu suoritettava tiedosto yksinkertaisesti ei ole PATH:ssa. Jos käytät Intel Macia ja kohtaat yhteensopivuusongelmia PATH:n korjaamisen jälkeen, tarkista nykyinen Flutterin tuettujen alustojen sivu ja SDK-arkisto ennen Flutter-version valitsemista.
Sinulla on luotettava asennus, kun aivan uusi Terminal-ikkuna löytää Flutterin ilman manuaalisia komentoja, flutter --version ja dart --version toimivat onnistuneesti, IDE:si tunnistaa SDK:n uudelleenkäynnistyksen jälkeen ja flutter doctor -v toimii riittävän pitkälle raportoidakseen kehitystyökalujesi todellisen tilan.
Jos nämä tarkistukset menevät läpi, lopeta PATH:n muuttaminen. Kaikki jäljellä olevat varoitukset tulisi käsitellä erillisinä asennusongelmina. Tämä pitää vianmääritysprosessin ennustettavana ja estää toimivan shell-konfiguraation muuttumisen tarpeettoman monimutkaiseksi.
Korjaa Linux ENOSPC -tiedostojen tarkkailijan virheet tarkistamalla inotify-rajoitukset, etsimällä tarkkailijapainotteisia prosesseja, nostamalla rajoituksia turvallisesti ja tekemällä muutoksista pysyviä.
Korjaa Tailwind CSS -tyylien päivittymättömyys Vite Reactissa tarkistamalla Tailwind v4 -asetukset, CSS-tuonnit, lähteen tunnistus, dynaamiset luokat, HMR ja vanhentuneet välimuistit.
Korjaa Python 3:n ModuleNotFoundError-virhe pip-funktiolle Windowsissa, macOS:ssä ja Linuxissa ensurepip-komennolla, käyttöjärjestelmäpaketeilla, virtuaaliympäristöillä ja tulkkitarkistuksilla.
Korjaa GitHub SSH -käyttöoikeus evätty (julkinen avain) -ongelma tarkistamalla isäntä, aktiivinen SSH-avain, GitHub-tili, kertakirjautumisen valtuutus, etä-URL-osoite ja portin 22 käyttöoikeus.
Korjaa Gitin ei-pikakelausvirhe turvallisesti. Suojaa paikallinen työ, nouda etäcommitit, valitse yhdistäminen tai uudelleenpohjustaminen, ratkaise ristiriidat ja puske muutosten menettämättä.
Korjaa Nginx 502 Bad Gateway -virheet Node.js:n avulla ylävirran puolella tarkistamalla sovellusportti, NGINX-lokit, proxy_pass-osoite, säilöverkko, aikakatkaisut ja uudelleenlataus.
Korjaa TypeScriptin virhe ”Type 'null' ei ole määritettävissä tyypille” yhdistämistyypeillä, rajaamisella, oletusarvoilla ja turvallisilla väitteillä strictNullChecksin avulla.
Korjaa Prisma Clientin luontivirhe tarkistamalla generaattori, skeema, tulostepolku, importit, versiot, monorepo-asetukset ja käyttöönoton build-vaiheet.
Korjaa Node.js ERR_MODULE_NOT_FOUND ESM:ssä tarkistamalla tuontipolut, tiedostopäätteet, pakettien asennuksen, viennit, ESM-tilan ja puhtaat asennukset.
Korjaa Gitin virhe "paikallisen myöntäjän varmenteen haku epäonnistui" tunnistamalla luottamuksen taustajärjestelmä, asentamalla oikea CA-ketju ja pitämällä SSL-varmenteiden tarkistus päällä.
