Short answer
Find the folder you unzipped Flutter into and add its bin folder to PATH. On a Mac, add export PATH="$HOME/develop/flutter/bin:$PATH" (with your real path) to ~/.zprofile. On Windows, add the bin folder to the Path user variable. Then close and reopen every terminal and your editor, and run flutter --version.
Why the shell can’t find flutter, and the fix
01
The bin folder was never added to PATH (macOS, Linux)
“At the end of your ~/.zprofile file, use the built-in export command to update the PATH variable to include the bin directory of your Flutter installation.” Flutter, Add Flutter to your PATH
Add one line at the end of ~/.zprofile on macOS (the default shell is zsh) or ~/.bashrc on most Linux setups. Add the full path to the bin folder, the one that contains the flutter file (for example .../flutter/bin). If it still fails in a new tab, put the same line in ~/.zshrc; with bash, use ~/.bashrc (bash: flutter: command not found).
# ~/.zprofile export PATH="$HOME/develop/flutter/bin:$PATH" # check which flutter flutter --version02
Windows: the Path variable is missing the entry
“To run flutter and dart commands in a terminal on Windows, add the Flutter SDK's bin directory to the Path environment variable.” Flutter, Add Flutter to your PATH
In Environment Variables, edit Path under your user variables, add the full path to flutter\bin (for example %USERPROFILE%\develop\flutter\bin), and move it to the top. Avoid folders that need admin rights, such as Program Files.
03
The terminal or editor was open before the change
“To apply this change and get access to the flutter tool, close and reopen all open Zsh sessions in your terminal apps and IDEs.” Flutter, Add Flutter to your PATH
PATH is read when a terminal or editor starts. A window opened before you edited the file still has the old PATH, and so do terminals inside VS Code or Android Studio until you quit and reopen the app.
04
The line went into the wrong file, or the SDK moved
On a Mac with bash, or with a custom shell, ~/.zprofile isn’t read; use your shell’s file. If you moved or renamed the Flutter folder, update the path, and check the SDK was fully extracted: ls <your-path>/bin/flutter must list the file. echo $PATH shows what the shell actually has. On a Mac, brew install --cask flutter is a quick alternative that puts flutter on PATH for you.
Checked against the vendor’s docs on : Flutter: Add Flutter to your PATH.
Rather hand it over?
Fixed scope, fixed price, paid upfront. The work happens in writing; no call needed.
- from $450App Fix TicketOne reproducible bug in an existing mobile or web app, diagnosed and fixed.See scope and start
- from $450AI-Built App RescueA Lovable, Bolt or Cursor app checked end to end in 3 days, then its worst problems fixed at a fixed price.No issues worth fixing, no charge. If the Launch Check finds nothing rated medium or higher, Simon refunds the full $450. You keep the report either way. This applies to the first 10 Launch Checks bought after October 30, 2026.See scope and start
Related: Flutter “cmdline-tools component is missing” · Android “SDK location not found” · Flutter “version solving failed” · Flutter “Flutter/Flutter.h file not found”