Om Terminalen returnerar zsh: command not found: flutter meddelar macOS dig att det aktuella skalet inte kan hitta ett program som heter flutter i de kataloger som listas i dess PATH. PATH är en miljövariabel: en lista över mappar som skalet söker igenom när du skriver ett kommando. Åtgärden är oftast enkel, men det är värt att kontrollera installationsplatsen innan du redigerar något.
För en nybörjare är målet inte bara att få ett Terminal-fönster att känna igen Flutter en gång. Ett bra resultat är att ett nyöppnat Terminal-fönster kan köra flutter --version, dart --version och flutter doctor -v utan meddelandet “command not found”. Din IDE bör också känna igen Flutter efter att den har startats om.
Per september 2026 återspeglar Flutters officiella installationsdokumentation dokumentuppsättningen för Flutter 3.47.2. Instruktionerna för macOS PATH utgår fortfarande från Apples standardskal, Zsh, och uppmanar användare att lägga till Flutter SDK:s bin-katalog i ~/.zprofile. Se Flutters officiella PATH-instruktioner. Apple bekräftar också att Zsh är standardskalet i Terminal på aktuella macOS-versioner: Apples dokumentation för Terminalskal.
Du behöver två saker: ett Flutter SDK som faktiskt finns på disken, och den exakta platsen för dess bin-mapp. SDK:n, eller mjukvaruutvecklingskitet, är samlingen av Flutters kommandoradsverktyg, bibliotek och stödfiler. bin-mappen inuti den innehåller den körbara kommandot som Terminalen behöver hitta.
Om du inte har installerat Flutter ännu hjälper det inte att lägga till en icke-existerande mapp i PATH. Följ Flutters manuella installationsguide eller den officiella VS Code-installationsvägen först. Flutters nuvarande macOS-instruktioner föreslår en skrivbar användarplats som ~/develop/ för ett manuellt extraherat SDK.
Öppna Terminalen och kör:
flutter --versionOm du ser ett meddelande som zsh: command not found: flutter, bekräfta vilket skal du använder:
echo $SHELLPå en typisk aktuell Mac är resultatet /bin/zsh. Om du använder Bash, Fish eller ett annat skal, redigera inte Zsh-filer blindt; startfilen är skal-specifik.
Hitta sedan ditt Flutter SDK. Om du följde exemplet med manuell installation, kontrollera:
ls "$HOME/develop/flutter/bin/flutter"Om det kommandot skriver ut filvägen finns SDK:n och det troliga problemet är PATH. Om det säger att filen inte finns, fortsätt inte med exempelvägen. Lokalisera den riktiga Flutter-mappen först. Du kan använda Finder, eller söka i troliga kataloger du valde när du extraherade SDK:n.
Flutters felsökningsdokumentation noterar också att om VS Code redan har konfigurerats för Flutter, kan Flutter-tillägget använda sin Locate SDK-prompt för att identifiera SDK-mappen. Se Felsökning av Flutter-installation.
För standard-Zsh-installationen som dokumenteras av Flutter på macOS, öppna eller skapa ~/.zprofile. Den inledande punkten betyder att det är en dold konfigurationsfil i din hemkatalog.
Du kan redigera den med vilken texteditor som helst. Från Terminalen är ett enkelt alternativ:
nano ~/.zprofileLägg till denna rad, ersätt sökvägen om din SDK finns någon annanstans:
export PATH="$HOME/develop/flutter/bin:$PATH"Detta betyder: placera Flutters bin-katalog i början av den befintliga PATH, behåll sedan alla kataloger som redan fanns där. Att sätta Flutter först är användbart om en annan föråldrad Flutter-installation dyker upp någon annanstans i PATH.
Spara filen. I Nano, tryck Control+O, tryck Return för att bekräfta filnamnet, och sedan Control+X för att avsluta.
~/.zprofile-kommandot som visas i artikeln; den avbildade editorn är illustrativ snarare än en riktig skärmdump.Du kan se äldre handledningar som säger att du ska redigera ~/.zshrc. Den filen kan fungera för interaktiv Zsh-konfiguration, men Flutters nuvarande macOS-installationssida instruerar specifikt användare att placera PATH-posten i ~/.zprofile. För en ny installation undviker att följa den nuvarande officiella vägen att blanda flera startfilskonventioner.
Apple förklarar en viktig anledning till att persistent konfiguration är viktigt: miljövariabler som ställs in i en skalsession visas inte automatiskt i andra oberoende Terminal-sessioner, och tillfälliga variabler försvinner när den sessionen stängs. Persistenta värden hör hemma i en skals startfil. Se Apples guide för miljövariabler.
Flutters macOS-instruktioner säger att du ska stänga och öppna alla öppna Zsh-sessioner i terminalappar och IDE:er efter att du ändrat PATH. Detta är lätt att missa. Ett terminalfönster som redan var öppet kan fortfarande använda den gamla miljön.
Avsluta och öppna Terminalen igen, kör sedan:
command -v flutter
flutter --version
dart --versioncommand -v flutter bör skriva ut sökvägen till Flutter-körbara filen, till exempel:
/Users/yourname/develop/flutter/bin/flutterVersionkommandona bör nu returnera versionsinformation snarare än “command not found”. Oroa dig inte om dina exakta versionsnummer skiljer sig från exempel du ser online; Flutter-utgåvor ändras över tid.
flutter --version i en nyöppnad terminal för att bekräfta att kommandot nu är upptäckbart.Om Flutter fungerar i Terminalen men fortfarande verkar saknas i VS Code eller en annan IDE, avsluta och öppna den IDE:n helt. Den officiella Flutter PATH-sidan inkluderar uttryckligen IDE-sessioner bland de applikationer som bör startas om efter att miljön har ändrats.
När flutter själv körs är PATH-felet löst. Nästa kommando är:
flutter doctor -vflutter doctor kontrollerar resten av din utvecklingsmiljö. För macOS-skrivbords- eller iOS-arbete kan den identifiera problem relaterade till Xcode och andra verktyg. Flutters officiella macOS-installationsguide rekommenderar att köra flutter doctor -v och sedan lösa alla rapporterade uppgifter innan du kör den igen. Se Flutters guide för macOS-utvecklingsinstallation.
Denna distinktion är viktig: om flutter doctor körs och rapporterar ett Xcode-problem har du inte längre ett “Flutter command not found”-problem. Att ändra PATH igen kommer inte att fixa ett saknat Xcode-licens, kommandoradsverktygskonfiguration, simulatorproblem eller andra verktygskedjeberoenden.
| Vad du ser | Vad det vanligtvis betyder | Vad du ska kontrollera härnäst |
|---|---|---|
~/develop/flutter/bin/flutter finns inte | Exempelvägen är fel för din Mac, eller SDK:n installerades/extraherades inte där. | Lokalisera den faktiska SDK:n innan du redigerar PATH. |
Den körbara filen finns, men command -v flutter returnerar ingenting | Flutter bin-katalogen finns inte i PATH som laddas av detta skal. | Kontrollera den exakta raden i ~/.zprofile, öppna sedan Terminalen igen. |
| Flutter fungerar i ett Terminal-fönster men inte ett annat | Sessionerna startades med olika miljöer eller skal-konfigurationer. | Stäng alla Terminal-fönster och starta en ny session; verifiera echo $SHELL. |
| Flutter fungerar i Terminalen men inte i en IDE-terminal | IDE:n kan fortfarande ha den gamla miljön. | Avsluta IDE:n helt och öppna den igen. |
flutter doctor -v körs men rapporterar andra fel | PATH är redan fixat; ett annat Flutter-beroende behöver uppmärksamhet. | Följ den specifika doctor-utdatan istället för att ändra PATH igen. |
.../flutter/bin, inte bara .../flutter./Users/alex/develop/flutter kommer inte att finnas på en Mac vars konto och installationskatalog är olika.:$PATH så att du behåller systemets befintliga kommandokataloger.flutter --version fungerar, gå vidare till flutter doctor -v.Flutters nuvarande dokumentation varnar för att stödet för Intel-baserade Macs (x64) fasas ut, medan Apple Silicon förblir den framåtblickande Mac-arkitekturen. Den livscykelförändringen förklarar normalt inte ett grundläggande zsh: command not found: flutter-meddelande när en installerad körbar fil helt enkelt inte finns i PATH. Om du är på en Intel Mac och stöter på kompatibilitetsproblem efter att ha fixat PATH, kontrollera den aktuella Flutter sidan för stödda plattformar och SDK-arkivet innan du väljer en Flutter-version.
Du har en pålitlig installation när ett helt nytt Terminal-fönster kan hitta Flutter utan manuella kommandon, flutter --version och dart --version körs framgångsrikt, din IDE känner igen SDK:n efter omstart, och flutter doctor -v körs tillräckligt långt för att rapportera det faktiska tillståndet för dina utvecklingsverktygskedjor.
Om dessa kontroller godkänns, sluta ändra PATH. Eventuella återstående varningar bör hanteras som separata installationsproblem. Det håller felsökningsprocessen förutsägbar och förhindrar att en fungerande skalkonfiguration blir mer komplicerad än nödvändigt.
Åtgärda Tailwind CSS-stilar som inte uppdateras i Vite React genom att kontrollera Tailwind v4-inställningar, CSS-importer, källkodsidentifiering, dynamiska klasser, HMR och inaktuella cacher.
Åtgärda Python 3:s ModuleNotFoundError för pip på Windows, macOS och Linux med ensurepip, OS-paket, virtuella miljöer och tolkkontroller.
Åtgärda GitHub SSH-behörighet nekad (publickey) genom att kontrollera värden, aktiv SSH-nyckel, GitHub-konto, SSO-auktorisering, fjärr-URL och port 22-åtkomst.
Åtgärda en Git-push som inte snabbspolar framåt på ett säkert sätt. Skydda lokalt arbete, hämta fjärrcommits, välj merge eller rebase, lös konflikter och pusha utan att förlora ändringar.
Åtgärda Nginx 502 Bad Gateway-fel med en Node.js-uppström genom att kontrollera appporten, NGINX-loggarna, proxy_pass-adressen, containernätverk, timeouts och omladdning.
Fix TypeScript's “Type 'null' is not assignable to type” error with union types, narrowing, defaults, and safe assertions under strictNullChecks.
Åtgärda felet att Prisma Client inte har genererats genom att kontrollera din generator, ditt schema, utdatasökvägen, importerna, versionerna, monorepo-konfigurationen och byggstegen vid distribution.
Åtgärda Node.js ERR_MODULE_NOT_FOUND i ESM genom att kontrollera importsökvägar, filtillägg, paketinstallation, exporter, ESM-läge och rena installationer.
Åtgärda Gits fel 'unable to get local issuer certificate' genom att identifiera förtroendebakgrunden, installera rätt CA-kedja och hålla SSL-verifieringen aktiverad.
Åtgärda MongoDB-nätverksavbrott i Mongoose genom att identifiera avbrottstypen, testa Atlas- eller TCP-anslutning, korrigera URI:n och justera tidsgränser endast när det är motiverat.
