Hvis Terminalen returnerer zsh: command not found: flutter, fortæller macOS dig, at den aktuelle shell ikke kan finde et program ved navn flutter i de mapper, der er angivet i dens PATH. PATH er en miljøvariabel: en liste over mapper, som shell'en søger i, når du indtaster en kommando. Løsningen er normalt ligetil, men det er værd at kontrollere installationsplaceringen, før du redigerer noget.
For en begynder er målet ikke blot at få ét Terminal-vindue til at genkende Flutter én gang. Et godt resultat er, at et nyåbnet Terminal-vindue kan køre flutter --version, dart --version og flutter doctor -v uden en "command not found"-besked. Din IDE bør også genkende Flutter, efter at den er genstartet.
Per september 2026 afspejler Flutters officielle installationsdokumentation dokumentationssættet for Flutter 3.47.2. macOS PATH-instruktionerne antager stadig Apples standardskal, Zsh, og beder brugere om at tilføje Flutter SDK's bin-mappe til ~/.zprofile. Se Flutters officielle PATH-instruktioner. Apple bekræfter også, at Zsh er standardskallen i Terminal på nuværende macOS-versioner: Apple Terminal shell-dokumentation.
Du har brug for to ting: en Flutter SDK, der faktisk findes på disken, og den præcise placering af dens bin-mappe. SDK'en, eller softwareudviklingssættet, er samlingen af Flutters kommandolinjeværktøjer, biblioteker og understøttende filer. bin-mappen inde i den indeholder den eksekverbare kommando, som Terminalen skal finde.
Hvis du ikke har installeret Flutter endnu, vil det ikke hjælpe at tilføje en ikke-eksisterende mappe til PATH. Følg Flutters manuelle installationsguide eller den officielle VS Code-installationsrute først. Flutters nuværende macOS-instruktioner foreslår en brugerskrivbar placering som ~/develop/ for en manuelt udpakket SDK.
Åbn Terminalen og kør:
flutter --versionHvis du ser en besked som zsh: command not found: flutter, skal du bekræfte, hvilken shell du bruger:
echo $SHELLPå en typisk nuværende Mac er resultatet /bin/zsh. Hvis du bruger Bash, Fish eller en anden shell, skal du ikke blindt redigere Zsh-filer; opstartsfilen er shell-specifik.
Find derefter din Flutter SDK. Hvis du fulgte eksemplet på manuel installation, skal du tjekke:
ls "$HOME/develop/flutter/bin/flutter"Hvis den kommando udskriver filstien, findes SDK'en, og det sandsynlige problem er PATH. Hvis den siger, at filen ikke findes, skal du ikke fortsætte med eksempelstien. Lokalisér den rigtige Flutter-mappe først. Du kan bruge Finder eller søge i sandsynlige mapper, du valgte, da du udpakkede SDK'en.
Flutters fejlfindingsdokumentation bemærker også, at hvis VS Code allerede er konfigureret til Flutter, kan Flutter-udvidelsen bruge sin Locate SDK-prompt til at identificere SDK-mappen. Se Flutter installationsfejlfinding.
For den standard Zsh-opsætning, som Flutter dokumenterer på macOS, skal du åbne eller oprette ~/.zprofile. Det indledende punktum betyder, at det er en skjult konfigurationsfil i din hjemmemappe.
Du kan redigere den med enhver teksteditor. Fra Terminalen er et simpelt valg:
nano ~/.zprofileTilføj denne linje, og erstat stien, hvis din SDK er et andet sted:
export PATH="$HOME/develop/flutter/bin:$PATH"Dette betyder: Sæt Flutters bin-mappe foran den eksisterende PATH, og behold derefter alle de mapper, der allerede var der. At sætte Flutter først er nyttigt, hvis en anden forældet Flutter-installation vises et andet sted i PATH.
Gem filen. I Nano skal du trykke på Control+O, trykke på Return for at bekræfte filnavnet og derefter Control+X for at afslutte.
~/.zprofile-kommando, der vises i artiklen; den afbildede editor er illustrativ snarere end et rigtigt skærmbillede.Du kan se ældre vejledninger fortælle dig at redigere ~/.zshrc. Den fil kan fungere til interaktiv Zsh-konfiguration, men Flutters nuværende macOS-installationsside instruerer specifikt brugere om at placere PATH-indgangen i ~/.zprofile. For en ny installation undgår det at følge den nuværende officielle sti at blande flere opstartsfil-konventioner.
Apple forklarer en vigtig årsag til, at vedvarende konfiguration er vigtig: miljøvariabler, der er indstillet i én shell-session, vises ikke automatisk i andre uafhængige Terminal-sessioner, og midlertidige variabler forsvinder, når den session lukkes. Vedvarende værdier hører til i en shell-opstartsfil. Se Apples guide til miljøvariabler.
Flutters macOS-instruktioner fortæller dig at lukke og genåbne alle åbne Zsh-sessioner i terminalapps og IDE'er efter ændring af PATH. Dette er let at overse. Et terminalvindue, der allerede var åbent, bruger måske stadig det gamle miljø.
Afslut og genåbn Terminalen, og kør derefter:
command -v flutter
flutter --version
dart --versioncommand -v flutter skal udskrive stien til Flutter-eksekverbaren, for eksempel:
/Users/yourname/develop/flutter/bin/flutterVersionkommandoerne skal nu returnere versionsinformation i stedet for "command not found." Bekymr dig ikke, hvis dine præcise versionsnumre adskiller sig fra eksempler, du ser online; Flutter-udgivelser ændrer sig over tid.
flutter --version igen i en nyåbnet terminal for at bekræfte, at kommandoen nu er opdagelig.Hvis Flutter virker i Terminalen, men stadig ser ud til at mangle i VS Code eller en anden IDE, skal du afslutte og genåbne den IDE helt. Den officielle Flutter PATH-side inkluderer eksplicit IDE-sessioner blandt de applikationer, der skal genstartes efter miljøændringer.
Når flutter selv kører, er PATH-fejlen løst. Den næste kommando er:
flutter doctor -vflutter doctor tjekker resten af dit udviklingsmiljø. Til macOS-skrivebord eller iOS-arbejde kan den identificere problemer relateret til Xcode og andre værktøjer. Flutters officielle macOS opsætningsguide anbefaler at køre flutter doctor -v og derefter løse eventuelle rapporterede opgaver, før den køres igen. Se Flutters macOS udviklingsopsætningsguide.
Denne distinktion er vigtig: hvis flutter doctor kører og rapporterer et Xcode-problem, har du ikke længere et "Flutter command not found"-problem. At ændre PATH igen vil ikke løse en manglende Xcode-licens, kommandolinjeværktøjskonfiguration, simulatorproblem eller anden værktøjskædeafhængighed.
| Hvad du ser | Hvad det normalt betyder | Hvad du skal tjekke næste |
|---|---|---|
~/develop/flutter/bin/flutter findes ikke | Eksempelstien er forkert for din Mac, eller SDK'en blev ikke installeret/udpakket der. | Lokalisér den faktiske SDK, før du redigerer PATH. |
Den eksekverbare fil findes, men command -v flutter returnerer intet | Flutter bin-mappen er ikke i den PATH, der er indlæst af denne shell. | Tjek den præcise linje i ~/.zprofile, og genåbn derefter Terminalen. |
| Flutter virker i ét Terminal-vindue, men ikke et andet | Sessionerne blev startet med forskellige miljøer eller shell-konfigurationer. | Luk alle Terminal-vinduer og start en frisk session; verificér echo $SHELL. |
| Flutter virker i Terminalen, men ikke i en IDE-terminal | IDE'en har måske stadig det gamle miljø. | Afslut IDE'en helt og genåbn den. |
flutter doctor -v kører, men rapporterer andre fejl | PATH er allerede fikset; en anden Flutter-afhængighed kræver opmærksomhed. | Følg den specifikke doctor-output i stedet for at ændre PATH igen. |
.../flutter/bin, ikke kun .../flutter./Users/alex/develop/flutter vil ikke eksistere på en Mac, hvis konto og installationsmappe er forskellige.:$PATH, så du beholder systemets eksisterende kommandomapper.flutter --version virker, skal du gå videre til flutter doctor -v.Flutters nuværende dokumentation advarer om, at understøttelse af Intel-baserede Macs (x64) udfases, mens Apple Silicon forbliver den fremadrettede Mac-arkitektur. Denne livscyklusændring forklarer normalt ikke en grundlæggende zsh: command not found: flutter-besked, når en installeret eksekverbar fil simpelthen ikke er i PATH. Hvis du er på en Intel Mac og oplever kompatibilitetsproblemer efter at have fikset PATH, skal du tjekke den nuværende Flutter understøttede platforme-side og SDK-arkivet, før du vælger en Flutter-version.
Du har en pålidelig opsætning, når et helt nyt Terminal-vindue kan finde Flutter uden manuelle kommandoer, flutter --version og dart --version kører med succes, din IDE genkender SDK'en efter genstart, og flutter doctor -v kører langt nok til at rapportere den faktiske tilstand af dine udviklingsværktøjskæder.
Hvis disse tjek bestås, skal du stoppe med at ændre PATH. Eventuelle tilbageværende advarsler skal håndteres som separate opsætningsproblemer. Det holder fejlfindingsprocessen forudsigelig og forhindrer, at en fungerende shell-konfiguration bliver mere kompliceret end nødvendigt.
Ret fejl i Linux ENOSPC-filovervågning ved at kontrollere inotify-grænser, finde processer med mange overvågningsbehov, hæve grænser sikkert og gøre ændringer permanente.
Ret problemer med Tailwind CSS-stilarter, der ikke opdateres i Vite React, ved at kontrollere Tailwind v4-opsætning, CSS-import, kildekodedetektion, dynamiske klasser, HMR og forældede cacher.
Ret Python 3's ModuleNotFoundError for pip på Windows, macOS og Linux med ensurepip, OS-pakker, virtuelle miljøer og fortolkertjek.
Ret GitHub SSH-tilladelse nægtet (publickey) ved at kontrollere værten, den aktive SSH-nøgle, GitHub-kontoen, SSO-godkendelsen, den eksterne URL og port 22-adgang.
Fix a Git non-fast-forward push safely. Protect local work, fetch remote commits, choose merge or rebase, resolve conflicts, and push without losing changes.
Ret Nginx 502 Bad Gateway-fejl med en Node.js upstream ved at kontrollere app-porten, NGINX-logfiler, proxy_pass-adresse, containernetværk, timeouts og genindlæsning.
Retter TypeScripts fejl "Type 'null' kan ikke tildeles til type" med foreningstyper, indsnævring, standardværdier og sikre påstande under strictNullChecks.
Ret fejlen med Prisma Client, der ikke er genereret, ved at kontrollere din generator, schema, output-sti, imports, versioner, monorepo-opsætning og build-trin til deployment.
Ret Node.js ERR_MODULE_NOT_FOUND i ESM ved at kontrollere importstier, filtypenavne, pakkeinstallation, eksport, ESM-tilstand og rene installationer.
Løs Git-fejlen 'unable to get local issuer certificate' ved at identificere tillidsbackenden, installere den korrekte CA-kæde og holde SSL-verifikation aktiveret.
