Pokud terminál vrátí zsh: command not found: flutter, macOS vám říká, že aktuální shell nemůže najít program s názvem flutter v adresářích uvedených v proměnné PATH. PATH je proměnná prostředí: seznam složek, které shell prohledává, když zadáte příkaz. Oprava je obvykle přímočará, ale před úpravou čehokoli stojí za to zkontrolovat umístění instalace.
Pro začátečníka není cílem jen nechat jeden okno terminálu rozpoznat Flutter jednou. Dobrým výsledkem je, že nově otevřené okno terminálu může spustit flutter --version, dart --version a flutter doctor -v bez zprávy „command not found“. Vaše IDE by mělo Flutter rozpoznat také po restartu.
K září 2026 oficiální instalační dokumentace Flutteru odráží dokumentační sadu Flutter 3.47.2. Pokyny pro PATH v systému macOS stále předpokládají výchozí shell společnosti Apple, Zsh, a vyzývají uživatele, aby přidali adresář bin SDK Flutteru do souboru ~/.zprofile. Viz Oficiální pokyny Flutteru pro PATH. Apple také potvrzuje, že Zsh je výchozím shellem v terminálu v aktuálních verzích macOS: Dokumentace shellu Apple Terminal.
Potřebujete dvě věci: SDK Flutteru, které skutečně existuje na disku, a přesné umístění jeho složky bin. SDK, nebo software development kit, je sbírka nástrojů Flutteru pro příkazový řádek, knihoven a podpůrných souborů. Složka bin uvnitř obsahuje spustitelný příkaz, který terminál potřebuje najít.
Pokud jste Flutter ještě nenainstalovali, přidání neexistující složky do PATH nepomůže. Nejprve postupujte podle Ručního instalačního průvodce Flutteru nebo oficiální instalační cesty VS Code. Aktuální pokyny Flutteru pro macOS doporučují umístění zapisovatelné uživatelem, jako je ~/develop/, pro ručně rozbalené SDK.
Otevřete terminál a spusťte:
flutter --versionPokud uvidíte zprávu jako zsh: command not found: flutter, potvrďte, který shell používáte:
echo $SHELLNa typickém aktuálním Macu je výsledkem /bin/zsh. Pokud používáte Bash, Fish nebo jiný shell, neupravujte slepě soubory Zsh; spouštěcí soubor je specifický pro daný shell.
Dále najděte své SDK Flutteru. Pokud jste postupovali podle příkladu ruční instalace, zkontrolujte:
ls "$HOME/develop/flutter/bin/flutter"Pokud tento příkaz vytiskne cestu k souboru, SDK existuje a pravděpodobným problémem je PATH. Pokud uvede, že soubor neexistuje, nepokračujte s příkladovou cestou. Nejprve najděte skutečnou složku Flutteru. Můžete použít Finder nebo prohledat pravděpodobné adresáře, které jste zvolili při rozbalování SDK.
Dokumentace pro řešení problémů Flutteru také uvádí, že pokud byl VS Code již nakonfigurován pro Flutter, rozšíření Flutter může použít výzvu Locate SDK k identifikaci složky SDK. Viz Řešení problémů s instalací Flutteru.
Pro výchozí nastavení Zsh zdokumentované Flutterem v systému macOS otevřete nebo vytvořte soubor ~/.zprofile. Tečka na začátku znamená, že se jedná o skrytý konfigurační soubor ve vašem domovském adresáři.
Můžete jej upravit libovolným textovým editorem. Z terminálu je jednoduchou možností:
nano ~/.zprofilePřidejte tento řádek a nahraďte cestu, pokud je vaše SDK jinde:
export PATH="$HOME/develop/flutter/bin:$PATH"To znamená: umístěte adresář bin Flutteru na začátek existujícího PATH a poté ponechte všechny adresáře, které tam již byly. Umístění Flutteru na první místo je užitečné, pokud se jiná zastaralá instalace Flutteru objeví jinde v PATH.
Uložte soubor. V Nano stiskněte Control+O, stiskněte Return pro potvrzení názvu souboru a poté Control+X pro ukončení.
~/.zprofile uvedeného v článku; zobrazený editor je ilustrativní, nikoli skutečný snímek obrazovky.Můžete narazit na starší tutoriály, které vám říkají, abyste upravili ~/.zshrc. Tento soubor může fungovat pro interaktivní konfiguraci Zsh, ale aktuální instalační stránka Flutteru pro macOS konkrétně vyzývá uživatele, aby umístili položku PATH do ~/.zprofile. U nové instalace dodržování aktuální oficiální cesty zabraňuje míšení několika konvencí spouštěcích souborů.
Apple vysvětluje důležitý důvod, proč je trvalá konfigurace důležitá: proměnné prostředí nastavené v jedné relaci shellu se automaticky neobjeví v jiných nezávislých relacích terminálu a dočasné proměnné zmizí, když se tato relace uzavře. Trvalé hodnoty patří do spouštěcího souboru shellu. Viz Průvodce proměnnými prostředí společnosti Apple.
Pokyny Flutteru pro macOS vám říkají, abyste po změně PATH zavřeli a znovu otevřeli všechny otevřené relace Zsh v aplikacích terminálu a IDE. To je snadné přehlédnout. Okno terminálu, které bylo již otevřeno, může stále používat staré prostředí.
Ukončete a znovu otevřete terminál a spusťte:
command -v flutter
flutter --version
dart --versioncommand -v flutter by měl vytisknout cestu ke spustitelnému souboru Flutteru, například:
/Users/yourname/develop/flutter/bin/flutterPříkazy pro verzi by nyní měly vrátit informace o verzi, nikoli „command not found“. Nemusíte se znepokojovat, pokud se vaše přesná čísla verzí liší od příkladů, které vidíte online; vydání Flutteru se v čase mění.
flutter --version v nově otevřeném terminálu, abyste potvrdili, že je příkaz nyní dostupný.Pokud Flutter funguje v terminálu, ale stále se zdá chybět ve VS Code nebo jiném IDE, úplně ukončete a znovu otevřete toto IDE. Oficiální stránka PATH Flutteru výslovně zahrnuje relace IDE mezi aplikace, které by měly být po změně prostředí restartovány.
Jakmile samotný příkaz flutter běží, chyba PATH je vyřešena. Dalším příkazem je:
flutter doctor -vflutter doctor kontroluje zbytek vašeho vývojového prostředí. Pro práci s desktopem macOS nebo iOS může identifikovat problémy související s Xcode a dalšími nástroji. Oficiální průvodce nastavením Flutteru pro macOS doporučuje spustit flutter doctor -v a poté vyřešit všechny hlášené úkoly před jeho opětovným spuštěním. Viz Průvodce nastavením vývoje pro macOS ve Flutteru.
Toto rozlišení je důležité: pokud flutter doctor běží a hlásí problém s Xcode, již nemáte problém „Flutter command not found“. Opětovná změna PATH nevyřeší chybějící licenci Xcode, konfiguraci nástrojů příkazového řádku, problém se simulátorem nebo jinou závislost nástrojového řetězce.
| Co vidíte | Co to obvykle znamená | Co zkontrolovat dál |
|---|---|---|
~/develop/flutter/bin/flutter neexistuje | Příkladová cesta je pro váš Mac špatná, nebo SDK nebylo nainstalováno/rozbaleno tam. | Najděte skutečné SDK před úpravou PATH. |
Spustitelný soubor existuje, ale command -v flutter nevrátí nic | Adresář bin Flutteru není v PATH načteném tímto shellem. | Zkontrolujte přesný řádek v ~/.zprofile a poté znovu otevřete terminál. |
| Flutter funguje v jednom okně terminálu, ale ne v druhém | Relace byly spuštěny s různými prostředími nebo konfiguracemi shellu. | Zavřete všechna okna terminálu a spusťte novou relaci; ověřte echo $SHELL. |
| Flutter funguje v terminálu, ale ne v terminálu IDE | IDE může mít stále staré prostředí. | Úplně ukončete IDE a znovu jej otevřete. |
flutter doctor -v běží, ale hlásí jiné chyby | PATH je již opraven; jiná závislost Flutteru vyžaduje pozornost. | Postupujte podle konkrétního výstupu doctoru místo opětovné změny PATH. |
.../flutter/bin, nikoli jen .../flutter./Users/alex/develop/flutter nebude existovat na Macu, jehož účet a instalační adresář jsou jiné.:$PATH, abyste zachovali stávající adresáře příkazů systému.flutter --version funguje, přejděte na flutter doctor -v.Aktuální dokumentace Flutteru varuje, že podpora pro Maci s procesorem Intel (x64) je postupně ukončována, zatímco Apple Silicon zůstává perspektivní architekturou Macu. Tato změna životního cyklu obvykle nevysvětluje základní zprávu zsh: command not found: flutter, když nainstalovaný spustitelný soubor prostě není v PATH. Pokud jste na Macu s procesorem Intel a po opravě PATH narazíte na problémy s kompatibilitou, zkontrolujte aktuální stránku podporovaných platforem Flutteru a archiv SDK před výběrem verze Flutteru.
Máte spolehlivé nastavení, když nově otevřené okno terminálu najde Flutter bez ručních příkazů, flutter --version a dart --version běží úspěšně, vaše IDE rozpozná SDK po restartu a flutter doctor -v běží dostatečně daleko, aby hlásil skutečný stav vašich vývojových nástrojových řetězců.
Pokud tyto kontroly projdou, přestaňte měnit PATH. Jakékoli zbývající varování by měla být řešena jako samostatné problémy s nastavením. To udržuje proces řešení problémů předvídatelný a zabraňuje tomu, aby funkční konfigurace shellu byla složitější, než je nutné.
Opravte chyby hlídače souborů ENOSPC v systému Linux kontrolou limitů inotify, nalezením procesů s vysokou mírou zátěže hlídače, bezpečným zvýšením limitů a trvalým uložením změn.
Fix Tailwind CSS styles not updating in Vite React by checking Tailwind v4 setup, CSS imports, source detection, dynamic classes, HMR, and stale caches.
Oprava chyby ModuleNotFoundError v Pythonu 3 pro PIP na Windows, macOS a Linuxu pomocí ensurepip, balíčků operačního systému, virtuálních prostředí a kontrol interpretů.
Opravte chybu „Oprávnění GitHub SSH odepřeno (veřejný klíč)“ kontrolou hostitele, aktivního klíče SSH, účtu GitHub, autorizace SSO, vzdálené adresy URL a přístupu na port 22.
Bezpečně opravte push chybu v Gitu, která neumožňuje rychlé přehrávání. Chraňte lokální práci, načítejte vzdálené commity, vyberte sloučení nebo rebase, vyřešte konflikty a pushujte bez ztráty změn.
Opravte chyby Nginx 502 Bad Gateway s upstreamem Node.js kontrolou portu aplikace, protokolů NGINX, adresy proxy_pass, sítě kontejnerů, časových limitů a opětovného načtení.
Oprava chyby „Typ 'null' nelze přiřadit typu“ v TypeScriptu u sjednocovacích typů, zúžení, výchozích hodnot a bezpečných asercí v rámci strictNullChecks.
Opravte chybu nevygenerovaného Prisma Client kontrolou generátoru, schématu, výstupní cesty, importů, verzí, nastavení monorepa a kroků sestavení při nasazení.
Opravte chybu Node.js ERR_MODULE_NOT_FOUND v ESM kontrolou cest importu, přípon souborů, instalace balíčků, exportů, režimu ESM a čistých instalací.
Opravte chybu Gitu 'nelze získat lokální certifikát vydavatele' identifikací důvěryhodného backendu, instalací správného řetězce CA a ponecháním ověřování SSL zapnutého.
