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 nedostatečné paměti CUDA v PyTorch pomocí praktického postupu: měřte paměť GPU, zmenšete pracovní množinu, použijte AMP a akumulaci gradientů, ukládejte aktivace (checkpointing) a laděte alokátor pouze v případě potřeby.
Opravte chybu CORS s chybějící hlavičkou Access-Control-Allow-Origin v Express.js diagnostikou původu, bezpečnou konfigurací cors, zpracováním preflight požadavků a ověřením hlaviček.
Opravte chybu Reactu „Cannot read properties of undefined (reading 'map')“ vysledováním nedefinované hodnoty, opravou stavu a dat z API a přidáním bezpečných ochranných mechanismů při vykreslování.
Opravte chybu Webpacku „Nelze vyřešit 'fs'“ správným řešením: přesuňte kód pouze pro Node na server, použijte závislost bezpečnou pro prohlížeč, nastavte fs:false pouze u volitelných funkcí nebo správně cílte na Node.
Opravte chybějící klíče API Supabase v Next.js, Vite, Node, nasazeních a Edge Functions. Použijte aktuální názvy publikovatelných/secret klíčů, správné soubory env a bezpečné kroky ověření.
Opravte chybu „flutter: command not found“ v systému macOS nalezením SDK Flutter, přidáním složky bin do proměnné PATH, znovu načtením Zsh a ověřením nastavení.
Opravte chybu „Port 8080 je již používán“ nalezením procesu, který port vlastní, jeho bezpečným zastavením, řešením problémů s Dockerem nebo výběrem nového portu.
Opravte chybu Django SECRET_KEY must not be empty kontrolou aktivního modulu nastavení, proměnných prostředí, generování klíče a konfigurace produkčního prostředí.
Opravte chybu „connection refused“ u PostgreSQL na localhost:5432 kontrolou stavu serveru, nástroje pg_isready, naslouchání na portu, souboru postgresql.conf, mapování Dockeru a ověřování.
Opravte nesoulad hydratace v Reactu nebo Next.js tak, aby se serverové HTML shodovalo s prvním vykreslením na klientovi, a poté ověřte výsledek ve vývojovém i produkčním prostředí.
