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.
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.
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.
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 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.
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.