Slik løser du feilen “Flutter Command Not Found” på macOS

Hvis Terminalen returnerer zsh: command not found: flutter, forteller macOS deg at det gjeldende skallet ikke finner et program med navnet flutter i mappene som er oppført i PATH. PATH er en miljøvariabel: en liste over mapper skallet søker i når du skriver en kommando. Løsningen er vanligvis enkel, men det er verdt å sjekke installasjonsstedet før du redigerer noe.

For en nybegynner er målet ikke bare å få ett Terminal-vindu til å gjenkjenne Flutter én gang. Et godt resultat er at et nylig åpnet Terminal-vindu kan kjøre flutter --version, dart --version og flutter doctor -v uten meldingen “command not found”. IDE-en din bør også gjenkjenne Flutter etter at den er startet på nytt.

Per september 2026 gjenspeiler Flutters offisielle installasjonsdokumentasjon dokumentasjonssettet for Flutter 3.47.2. PATH-instruksjonene for macOS antar fortsatt Apples standardskall, Zsh, og ber brukere om å legge til Flutter SDKs bin-mappe i ~/.zprofile. Se Flutters offisielle PATH-instruksjoner. Apple bekrefter også at Zsh er standardskallet i Terminal på gjeldende macOS-versjoner: Apples Terminal-skall dokumentasjon.

Før du endrer PATH: Hva trenger du?

Du trenger to ting: en Flutter SDK som faktisk finnes på disken, og den nøyaktige plasseringen av bin-mappen. SDKen, eller programvareutviklingssettet, er samlingen av Flutters kommandolinjeverktøy, biblioteker og støttende filer. bin-mappen inneholder den eksekverbare kommandoen som Terminalen må finne.

Hvis du ikke har installert Flutter ennå, vil det ikke hjelpe å legge til en ikke-eksisterende mappe i PATH. Følg Flutters manuelle installasjonsguide eller den offisielle VS Code-installasjonsruten først. Flutters gjeldende macOS-instruksjoner foreslår en skrivbar plassering for brukeren, som ~/develop/, for et manuelt pakket ut SDK.

Steg 1: Bekreft feilen og finn Flutter SDK

Åpne Terminalen og kjør:

flutter --version

Hvis du ser en melding som zsh: command not found: flutter, bekreft hvilket skall du bruker:

echo $SHELL

På en typisk gjeldende Mac er resultatet /bin/zsh. Hvis du bruker Bash, Fish eller et annet skall, rediger ikke Zsh-filer blindt; oppstartsfilen er skallspesifikk.

macOS Terminal som viser zsh command not found etter å ha kjørt flutter --version — AI-generert illustrasjon: Terminalen rapporterer at Zsh ikke finner Flutter-kommandoen. Det er en illustrasjon, ikke et fangstet testresultat.

Deretter finner du Flutter SDK. Hvis du fulgte eksemplet på manuell installasjon, sjekk:

ls "$HOME/develop/flutter/bin/flutter"

Hvis den kommandoen skriver ut filbanen, finnes SDK-en, og det sannsynlige problemet er PATH. Hvis den sier at filen ikke finnes, ikke fortsett med eksempelbanen. Finn den virkelige Flutter-mappen først. Du kan bruke Finder, eller søke i sannsynlige mapper du valgte da du pakket ut SDK-en.

Flutters feilsøkingsdokumentasjon merker også at hvis VS Code allerede er konfigurert for Flutter, kan Flutter-utvidelsen bruke Locate SDK-meldingen for å identifisere SDK-mappen. Se Flutter installasjonsfeilsøking.

Finder som viser et eksempel på Flutter SDK-mappe med bin-katalogen på macOS — AI-generert illustrasjon: en eksempel Flutter SDK-mappe i en brukerutviklingskatalog. Din faktiske mappenavn og plassering kan variere.

Steg 2: Legg til Flutter bin-mappen i PATH

For standard Zsh-oppsettet dokumentert av Flutter på macOS, åpne eller opprett ~/.zprofile. Det ledende punktet betyr at det er en skjult konfigurasjonsfil i hjemmemappen din.

Du kan redigere den med ethvert tekstredigeringsprogram. Fra Terminalen er et enkelt alternativ:

nano ~/.zprofile

Legg til denne linjen, og erstatt banen hvis SDK-en din er et annet sted:

export PATH="$HOME/develop/flutter/bin:$PATH"

Dette betyr: sett Flutter sin bin-katalog foran den eksisterende PATH-en, og behold deretter alle katalogene som allerede var der. Å sette Flutter først er nyttig hvis en annen utdatert Flutter-installasjon dukker opp et annet sted i PATH.

Lagre filen. I Nano, trykk Control+O, trykk Return for å bekrefte filnavnet, og deretter Control+X for å avslutte.

Kodeeditor illustrasjon av å legge til Flutter bin-katalogen i et shell PATH — AI-generert illustrasjon av en Flutter PATH-oppføring. Følg den nøyaktige `~/.zprofile`-kommandoen som vises i artikkelen; den avbildede editoren er illustrativ og ikke et ekte skjermbilde.

Hvorfor ikke automatisk bruke .zshrc?

Du kan se eldre opplæringsprogrammer som sier at du skal redigere ~/.zshrc. Den filen kan fungere for interaktiv Zsh-konfigurasjon, men Flutters gjeldende macOS-installasjonsside instruerer brukere spesifikt om å plassere PATH-oppføringen i ~/.zprofile. For et nytt installasjon, unngår å følge den gjeldende offisielle banen å blande flere oppstartsfilkonvensjoner.

Apple forklarer en viktig grunn til at vedvarende konfigurasjon er viktig: miljøvariabler satt i én skallsesjon vises ikke automatisk i andre uavhengige Terminal-sesjoner, og midlertidige variabler forsvinner når den sesjonen lukkes. Vedvarende verdier hører hjemme i en skalloppstartsfil. Se Apples miljøvariabelguide.

Steg 3: Åpne Terminalen på nytt og verifiser kommandoen

Flutters macOS-instruksjoner sier at du skal lukke og åpne alle åpne Zsh-sesjoner i terminalapper og IDE-er etter at du har endret PATH. Dette er lett å overse. Et terminalvindu som allerede var åpent, kan fortsatt bruke det gamle miljøet.

Avslutt og åpne Terminalen på nytt, og kjør deretter:

command -v flutter
flutter --version
dart --version

command -v flutter skal skrive ut banen til Flutter-eksekverbaren, for eksempel:

/Users/yourname/develop/flutter/bin/flutter

Versjonskommandoene skal nå returnere versjonsinformasjon i stedet for “command not found”. Ikke bekymre deg hvis dine nøyaktige versjonsnumre avviker fra eksempler du ser på nettet; Flutter-utgivelser endres over tid.

Terminal kommandolinje som kjører flutter --version etter at PATH er korrigert — AI-generert illustrasjon: kjør `flutter --version` på nytt i et nylig åpnet terminal for å bekrefte at kommandoen nå er oppdagbar.

Hvis Flutter fungerer i Terminalen, men fortsatt mangler i VS Code eller en annen IDE, avslutt IDE-en helt og åpne den på nytt. Den offisielle Flutter PATH-siden inkluderer uttrykkelig IDE-sesjoner blant applikasjonene som skal startes på nytt etter at miljøet endres.

Steg 4: Kjør Flutter Doctor og skill PATH-problemer fra verktøykjedeproblemer

Når flutter selv kjører, er PATH-feilen løst. Den neste kommandoen er:

flutter doctor -v

flutter doctor sjekker resten av utviklingsmiljøet ditt. For macOS-skrivebord eller iOS-arbeid kan den identifisere problemer relatert til Xcode og andre verktøy. Flutters offisielle macOS-oppsettsguide anbefaler å kjøre flutter doctor -v og deretter løse eventuelle rapporterte oppgaver før du kjører den igjen. Se Flutters macOS utviklingsoppsettsguide.

Denne distinksjonen er viktig: hvis flutter doctor kjører og rapporterer et Xcode-problem, har du ikke lenger et “Flutter command not found”-problem. Å endre PATH igjen vil ikke fikse en manglende Xcode-lisens, kommandolinjeverktøykonfigurasjon, simulatorproblem eller annen verktøykjedeavhengighet.

Hvis det fortsatt sier “Flutter: Command Not Found”

Hva du ser	Hva det vanligvis betyr	Hva du skal sjekke neste
`~/develop/flutter/bin/flutter` finnes ikke	Eksempelbanen er feil for din Mac, eller SDK-en ble ikke installert/pakket ut der.	Finn den faktiske SDK-en før du redigerer PATH.
Den eksekverbare filen finnes, men `command -v flutter` returnerer ingenting	Flutter bin-katalogen er ikke i PATH-en som lastes av dette skallet.	Sjekk den nøyaktige linjen i `~/.zprofile`, og åpne Terminalen på nytt.
Flutter fungerer i ett Terminal-vindu, men ikke et annet	Sesjonene ble startet med forskjellige miljøer eller skallkonfigurasjoner.	Lukk alle Terminal-vinduer og start en ny sesjon; verifiser `echo $SHELL`.
Flutter fungerer i Terminalen, men ikke i en IDE-terminal	IDE-en kan fortsatt ha det gamle miljøet.	Avslutt IDE-en helt og åpne den på nytt.
`flutter doctor -v` kjører, men rapporterer andre feil	PATH er allerede fikset; en annen Flutter-avhengighet trenger oppmerksomhet.	Følg den spesifikke doctor-outputen i stedet for å endre PATH igjen.

Vanlige nybegynnerfeil å unngå

Å legge til SDK-roten i stedet for bin-mappen. PATH bør inneholde noe som .../flutter/bin, ikke bare .../flutter.
Å kopiere noens andres bane bokstavelig. /Users/alex/develop/flutter vil ikke eksistere på en Mac der kontoen og installasjonskatalogen er forskjellig.
Å overskrive PATH. Bruk :$PATH slik at du beholder systemets eksisterende kommandokataloger.
Å redigere flere oppstartsfiler samtidig. Dette kan skape duplikate PATH-oppføringer og gjør senere feilsøking vanskeligere. Start med filen i de gjeldende Flutter macOS-instruksjonene.
Å teste bare i en gammel terminalfanen. Åpne terminal- og IDE-sesjoner på nytt etter at du har redigert det vedvarende miljøet.
Å anta at hver senere Flutter-feil fortsatt er et PATH-problem. Hvis flutter --version fungerer, gå videre til flutter doctor -v.

Hva med Intel Macs?

Flutters gjeldende dokumentasjon advarer om at støtten for Intel-baserte Macs (x64) fases ut, mens Apple Silicon forblir den fremtidsrettede Mac-arkitekturen. Denne livssyklusendringen forklarer normalt ikke en grunnleggende zsh: command not found: flutter-melding når en installert eksekverbar fil simpelthen ikke er i PATH. Hvis du er på en Intel Mac og møter kompatibilitetsproblemer etter at PATH er fikset, sjekk den gjeldende Flutter støttede plattformer-siden og SDK-arkivet før du velger en Flutter-versjon.

Hvordan vet du at fiksen er fullført?

Du har et pålitelig oppsett når et helt nytt Terminal-vindu kan finne Flutter uten manuelle kommandoer, flutter --version og dart --version kjører vellykket, IDE-en din gjenkjenner SDK-en etter omstart, og flutter doctor -v kjører langt nok til å rapportere den faktiske tilstanden til utviklingsverktøykjedene dine.

Hvis disse sjekkene består, slutt å endre PATH. Eventuelle gjenværende advarsler bør håndteres som separate oppsettproblemer. Det holder feilsøkingsprosessen forutsigbar og forhindrer at en fungerende skallkonfigurasjon blir mer komplisert enn nødvendig.

Offisielle referanser

Legg igjen en kommentar

Slik fikser du intern feil 500 i Next.js Server Components

Fiks Next.js Server Component 500-feil ved å spore serverlogger, sjekke datahenting og miljøvariabler, håndtere feil og verifisere produksjonsbygget.

Slik fikser du Kubernetes CrashLoopBackOff i lokal Minikube

Diagnostiser og fiks Kubernetes CrashLoopBackOff i lokal Minikube ved å sjekke pod-tilstand, tidligere logger, avslutningsårsaker, prober, konfigurasjon, minsegrenser og klusterhelse.

Slik fikser du at Docker Desktop-motoren stopper på Windows 11

Fiks Docker Desktop-motoren som stopper på Windows 11 ved å sjekke Docker-status, oppdatere og starte WSL 2 på nytt, verifisere virtualisering og bruke diagnostikk før nullstilling.

Slik løser du Uncaught ReferenceError: process is not defined i Vite

Løs Vite-feilen 'process is not defined' ved å erstatte Node-stil bruk av process.env, konfigurere VITE_-variabler riktig og sjekke avhengigheter.

Slik løser du “PyTorch CUDA Out of Memory” under modelltrening

Løs PyTorch CUDA out-of-memory-feil med en praktisk arbeidsflyt: mål GPU-minne, reduser arbeidssettet, bruk AMP og akkumulering, sjekkpoint-aktiveringer, og juster allokatoren kun ved behov.

Slik fikser du manglende CORS-header Access-Control-Allow-Origin i Express.js

Fiks manglende Access-Control-Allow-Origin CORS-feil i Express.js ved å diagnostisere opprinnelsen, konfigurere cors trygt, håndtere preflight og verifisere headers.

Slik fikser du feilen “Cannot Read Properties of Undefined (Reading map)” i React

Fiks React-feilen “Cannot read properties of undefined (reading 'map')” ved å spore opp den udefinerte verdien, korrigere state og API-data, og legge til sikre gjengivelseskontroller.

Slik løser du feilen «Module not found: Can’t resolve 'fs'» i Webpack

Løs Webpack-feilen «Can’t resolve 'fs'» ved å velge riktig løsning: flytt Node-kun-kode til serveren, bruk en nettlesersikker avhengighet, sett fs:false kun hvis valgfritt, eller mål mot Node riktig.

Slik fikser du at Supabase API-nøkkel ikke finnes i miljøvariabler

Fiks manglende Supabase API-nøkler i Next.js, Vite, Node, utplasseringer og Edge Functions. Bruk gjeldende navn på publiserbare/secret-nøkler, korrekte env-filer og trygge verifiseringstrinn.

Slik løser du feilen “Flutter Command Not Found” på macOS

Løs feilen “flutter: command not found” på macOS ved å finne Flutter SDK, legge til bin-mappen i PATH, laste inn Zsh på nytt og verifisere oppsettet.