Ja terminālis atgriež zsh: command not found: flutter, macOS jums norāda, ka pašreizējā čaula (shell) nevar atrast programmu ar nosaukumu flutter direktorijās, kas norādītas tās PATH mainīgajā. PATH ir vides mainīgais: mapju saraksts, kuras čaula meklē, kad ievadāt komandu. Labojums parasti ir vienkāršs, taču pirms kaut ko maināt, ir vērts pārbaudīt instalācijas atrašanās vietu.
Sācējam mērķis nav tikai likt vienam termināļa logam vienreiz atpazīt Flutter. Labs rezultāts ir tad, ja jaunā termināļa logā var palaist komandas flutter --version, dart --version un flutter doctor -v, nesaņemot paziņojumu “command not found”. Jūsu IDE pēc restartēšanas arī jāatpazīst Flutter.
2026. gada septembrī Flutter oficiālā instalācijas dokumentācija atbilst Flutter 3.47.2 dokumentācijas kopumam. macOS PATH norādījumi joprojām paredz Apple noklusējuma čaulu Zsh un lietotājiem iesaka pievienot Flutter SDK bin direktoriju failam ~/.zprofile. Skatiet Flutter oficiālos PATH norādījumus. Apple arī apstiprina, ka Zsh ir noklusējuma čaula terminālī pašreizējās macOS versijās: Apple Terminal čaulas dokumentācija.
Jums ir nepieciešamas divas lietas: Flutter SDK, kas reāli eksistē diskā, un precīza tā bin mapes atrašanās vieta. SDK jeb programmatūras izstrādes komplekts ir Flutter komandrīka rīku, bibliotēku un atbalsta failu kopums. Tajā esošajā bin mapē atrodas izpildāmā komanda, kas terminālim jāatrod.
Ja vēl neesat instalējis Flutter, neeksistējošas mapes pievienošana PATH nepalīdzēs. Vispirms sekojiet Flutter manuālās instalācijas rokasgrāmatai vai oficiālajam VS Code instalācijas ceļam. Flutter pašreizējie macOS norādījumi manuāli izpakotam SDK ierosina lietotāja rakstāmā vietu, piemēram, ~/develop/.
Atveriet termināli un palaidiet:
flutter --versionJa redzat paziņojumu, piemēram, zsh: command not found: flutter, pārbaudiet, kuru čaulu izmantojat:
echo $SHELLTipiskā pašreizējā Mac datorā rezultāts ir /bin/zsh. Ja izmantojat Bash, Fish vai citu čaulu, neakli rediģējiet Zsh failus; starta fails ir specifisks konkrētajai čaulai.
Tālāk atrodiet savu Flutter SDK. Ja sekojāt manuālās instalācijas piemēram, pārbaudiet:
ls "$HOME/develop/flutter/bin/flutter"Ja šī komanda izvada faila ceļu, SDK eksistē, un visticamākā problēma ir PATH. Ja tā norāda, ka fails neeksistē, nepārtrauciet ar piemēra ceļu. Vispirms atrodiet īsto Flutter mapi. Varat izmantot Finder vai meklēt iespējamās direktorijas, kuras izvēlējāties, izpakojot SDK.
Flutter problēmu novēršanas dokumentācija arī norāda, ka, ja VS Code jau ir konfigurēts Flutter, Flutter paplašinājums var izmantot savu Locate SDK uzvedni, lai identificētu SDK mapi. Skatiet Flutter instalācijas problēmu novēršanu.
Pēc noklusējuma Zsh konfigurācijai, ko Flutter dokumentē macOS, atveriet vai izveidojiet failu ~/.zprofile. Sākotnējais punkts nozīmē, ka tas ir slēpts konfigurācijas fails jūsu mājas direktorijā.
To varat rediģēt ar jebkuru teksta redaktoru. No termināļa vienkārša opcija ir:
nano ~/.zprofilePievienojiet šo rindu, aizstājot ceļu, ja jūsu SDK atrodas citur:
export PATH="$HOME/develop/flutter/bin:$PATH"Tas nozīmē: ievietojiet Flutter bin direktoriju esošā PATH sākumā, pēc tam saglabājiet visas jau esošās direktorijas. Flutter ievietošana pirmajā vietā ir noderīga, ja cita novecojusi Flutter instalācija parādās citur PATH.
Saglabājiet failu. Nano redaktorā nospiediet Control+O, nospiediet Return, lai apstiprinātu faila nosaukumu, un pēc tam Control+X, lai izietu.
~/.zprofile komandai, kas parādīta rakstā; attēlotais redaktors ir ilustratīvs, nevis reāls ekrānuzņēmums.Jūs varat sastapt vecākus apmācību materiālus, kas iesaka rediģēt ~/.zshrc. Šis fails var darboties interaktīvai Zsh konfigurācijai, taču Flutter pašreizējā macOS instalācijas lapa konkrēti norāda lietotājiem ievietot PATH ierakstu failā ~/.zprofile. Jaunai instalācijai sekošana pašreizējam oficiālajam ceļam ļauj izvairīties no vairāku starta failu konvenciju sajaukšanas.
Apple izskaidro svarīgu iemeslu, kāpēc pastāvīga konfigurācija ir svarīga: vides mainīgie, kas iestatīti vienā čaulas sesijā, automātiski neparādās citās neatkarīgās termināļa sesijās, un pagaidu mainīgie pazūd, kad šī sesija tiek aizvērta. Pastāvīgās vērtības pieder čaulas starta failā. Skatiet Apple vides mainīgo rokasgrāmatu.
Flutter macOS norādījumi liek pēc PATH maiņas aizvērt un atkārtoti atvērt visas atvērtās Zsh sesijas termināļa lietotnēs un IDE. To ir viegli palaist garām. Termināļa logs, kas jau bija atvērts, var joprojām izmantot veco vidi.
Aizveriet un atkārtoti atveriet termināli, pēc tam palaidiet:
command -v flutter
flutter --version
dart --versionKomandai command -v flutter jāizvada ceļš uz Flutter izpildāmo failu, piemēram:
/Users/yourname/develop/flutter/bin/flutterVersijas komandām tagad jāatgriež versijas informācija, nevis “command not found”. Neuztraucieties, ja jūsu precīzie versijas numuri atšķiras no piemēriem, ko redzat internetā; Flutter izlaidumi laika gaitā mainās.
flutter --version jaunā termināļa logā, lai pārliecinātos, ka komanda tagad ir atrodama.Ja Flutter darbojas terminālī, bet joprojām šķiet trūkstošs VS Code vai citā IDE, pilnībā aizveriet un atkārtoti atveriet šo IDE. Oficiālā Flutter PATH lapa skaidri iekļauj IDE sesijas lietotnēs, kuras jārestartē pēc vides izmaiņām.
Kad pats flutter darbojas, PATH kļūda ir atrisināta. Nākamā komanda ir:
flutter doctor -vflutter doctor pārbauda pārējo jūsu izstrādes vidi. macOS darbvirsmas vai iOS izstrādei tas var identificēt problēmas, kas saistītas ar Xcode un citiem rīkiem. Flutter oficiālā macOS iestatīšanas rokasgrāmata iesaka palaist flutter doctor -v un pēc tam atrisināt ziņotos uzdevumus, pirms to palaiž atkārtoti. Skatiet Flutter macOS izstrādes iestatīšanas rokasgrāmatu.
Šī atšķirība ir svarīga: ja flutter doctor darbojas un ziņo par Xcode problēmu, jums vairs nav problēmas “Flutter command not found”. PATH maiņa vēlreiz nelabos trūkstošu Xcode licenci, komandrīka rīku konfigurāciju, simulatora problēmu vai citu rīknes atkarību.
| Ko jūs redzat | Parasti tas nozīmē | Ko pārbaudīt tālāk |
|---|---|---|
~/develop/flutter/bin/flutter neeksistē | Piemēra ceļš jūsu Mac datoram ir nepareizs, vai SDK tur netika instalēts/izpakots. | Atrodiet faktisko SDK pirms PATH rediģēšanas. |
Izpildāmais fails eksistē, bet command -v flutter neko neatgriež | Flutter bin direktorija nav PATH, ko ielādē šī čaula. | Pārbaudiet precīzo rindu failā ~/.zprofile, pēc tam atkārtoti atveriet termināli. |
| Flutter darbojas vienā termināļa logā, bet ne otrā | Sesijas tika sāktas ar dažādām vidēm vai čaulu konfigurācijām. | Aizveriet visus termināļa logus un sāciet jaunu sesiju; pārbaudiet echo $SHELL. |
| Flutter darbojas terminālī, bet ne IDE terminālī | IDE var joprojām izmantot veco vidi. | Pilnībā aizveriet IDE un atkārtoti to atveriet. |
flutter doctor -v darbojas, bet ziņo par citām kļūdām | PATH jau ir labots; uzmanības prasa cita Flutter atkarība. | Sekojiet konkrētajam doctor izvadam, nevis mainiet PATH vēlreiz. |
.../flutter/bin, nevis tikai .../flutter./Users/alex/develop/flutter neeksistēs Mac datorā, kura konts un instalācijas direktorija ir atšķirīgi.:$PATH, lai saglabātu sistēmas esošās komandu direktorijas.flutter --version darbojas, pārejiet uz flutter doctor -v.Flutter pašreizējā dokumentācija brīdina, ka atbalsts Intel bāzētiem Mac datoriem (x64) tiek pakāpeniski izbeigts, savukārt Apple Silicon paliek perspektīvā Mac arhitektūra. Šī dzīves cikla maiņa parasti neizskaidro pamata zsh: command not found: flutter paziņojumu, kad instalētais izpildāmais fails vienkārši nav PATH. Ja izmantojat Intel Mac un pēc PATH labošanas saskaraties ar saderības problēmām, pirms Flutter versijas izvēles pārbaudiet pašreizējo Flutter atbalstīto platformu lapu un SDK arhīvu.
Jums ir uzticama iestatīšana, kad pilnīgi jauns termināļa logs var atrast Flutter bez manuālām komandām, flutter --version un dart --version darbojas veiksmīgi, jūsu IDE pēc restartēšanas atpazīst SDK, un flutter doctor -v darbojas pietiekami tālu, lai ziņotu par faktisko jūsu izstrādes rīkņu stāvokli.
Ja šīs pārbaudes izdodas, pārtrauciet mainīt PATH. Jebkurus atlikušos brīdinājumus jārisina kā atsevišķas iestatīšanas problēmas. Tas padara problēmu novēršanas procesu paredzamu un novērš darbspējīgas čaulas konfigurācijas kļūšanu sarežģītāku, nekā nepieciešams.
Novērsiet Linux ENOSPC failu vērotāja kļūdas, pārbaudot inotify ierobežojumus, atrodot procesus, kuros ir daudz vērotāja resursu, droši paaugstinot ierobežojumus un padarot izmaiņas pastāvīgas.
Novērsiet Tailwind CSS stilu neatjaunināšanu pakalpojumā Vite React, pārbaudot Tailwind v4 iestatījumus, CSS importēšanu, avota noteikšanu, dinamiskās klases, HMR un novecojušas kešatmiņas.
Novērsiet Python 3 ModuleNotFoundError kļūdu pip funkcijai operētājsistēmās Windows, macOS un Linux, izmantojot ensurepip, OS pakotnes, virtuālās vides un interpretētāja pārbaudes.
Novērsiet GitHub SSH atļaujas liegšanu (publiskā atslēga), pārbaudot resursdatoru, aktīvo SSH atslēgu, GitHub kontu, SSO autorizāciju, attālo URL un 22. porta piekļuvi.
Droši izlabojiet Git ne-ātrās pārtīšanas kļūdu. Aizsargājiet lokālo darbu, ielādējiet attālinātus izmaiņu izmaiņu ierakstus, izvēlieties apvienošanu vai atkārtotu bāzi, atrisiniet konfliktus un veiciet izmaiņu pārtīšanu, nezaudējot izmaiņas.
Izlabojiet Nginx 502 Bad Gateway kļūdas ar Node.js augšupējo resursu, pārbaudot lietotnes portu, NGINX žurnālus, proxy_pass adresi, konteineru tīklošanu, taimautus un atkārtotu ielādi.
Novērsta TypeScript kļūda “Tips 'null' nav piešķirams tipam”, izmantojot apvienošanas tipus, sašaurināšanu, noklusējuma vērtības un drošas apgalvojumus, izmantojot strictNullChecks.
Novērsiet Prisma Client ģenerēšanas kļūdu, pārbaudot savu ģeneratoru, shēmu, izvades ceļu, importus, versijas, monorepo iestatījumu un izvietošanas būvēšanas soļus.
Izlabojiet Node.js ERR_MODULE_NOT_FOUND kļūdu ESM, pārbaudot importēšanas ceļus, failu paplašinājumus, pakotņu instalēšanu, eksportēšanu, ESM režīmu un tīrās instalācijas.
Novērsiet Git kļūdu “nevar iegūt vietējo izdevēja sertifikātu”, identificējot uzticības aizmugurprogrammu, instalējot pareizo CA ķēdi un saglabājot SSL verifikāciju iespējotu.
