Troubleshooting 'zsh: command not found: flutter' Error: Quick Fixes and Solutions

Facing the 'zsh: command not found: flutter' error? Don't worry! In this guide, we'll help you identify the cause and provide step-by-step solutions to fix this issue. By the end of this guide, you'll be well-equipped to resolve the error and continue working with Flutter.

Table of Contents

  1. Understanding the Error
  2. Quick Fixes
  3. Solutions
  1. FAQs

Understanding the Error

The 'zsh: command not found: flutter' error typically occurs when your system cannot find the Flutter executable in the current directory or any directories listed in the PATH variable. This error is common when using the zsh shell, as it does not read the PATH variable from the same files as the bash shell.

Quick Fixes

Before diving into detailed solutions, try these quick fixes to resolve the error:

  1. Restart your terminal.
  2. Run source ~/.zshrc to reload the zsh configuration.
  3. Check your PATH variable with echo $PATH and ensure the Flutter path is included.

If these quick fixes don't resolve the issue, proceed to the solutions below.


Solution 1: Verify Flutter Installation

First, verify that Flutter is installed correctly on your system. You can do this by following the official Flutter installation guide.

Solution 2: Add Flutter to PATH

If Flutter is installed correctly but the error persists, ensure that the Flutter executable is included in your PATH variable.

Locate the Flutter SDK directory. By default, it is installed in the following locations:

  • macOS: ~/development/flutter/bin
  • Windows: C:\src\flutter\bin
  • Linux: ~/development/flutter/bin

Add the Flutter SDK directory to your PATH variable by editing the appropriate configuration file for your shell:

  • For zsh: Edit ~/.zshrc
  • For bash: Edit ~/.bashrc or ~/.bash_profile

To edit your configuration file, open it in a text editor and add the following line, replacing /path/to/flutter/bin with the correct path to the Flutter SDK directory:

export PATH="$PATH:/path/to/flutter/bin"

Save the file and restart your terminal or run source ~/.zshrc (for zsh) or source ~/.bashrc (for bash) to reload the configuration.

Solution 3: Configure the zsh Shell

If you're using the zsh shell, you may need to configure it to include the PATH variable from your bash configuration files.

Open your ~/.zshrc file in a text editor.

Add the following lines to the file:

# Load PATH from .bash_profile
if [ -f ~/.bash_profile ]; then
  source ~/.bash_profile

Save the file and restart your terminal or run source ~/.zshrc to reload the configuration.


Q1: How do I check which shell I am using?

Run the following command in your terminal:

echo $SHELL

It will display the path to your current shell, such as /bin/zsh or /bin/bash.

Q2: Can I use both bash and zsh on my system?

Yes, you can have both shells installed on your system, and you can switch between them by running chsh -s /bin/zsh or chsh -s /bin/bash.

Q3: What is the difference between zsh and bash?

zsh and bash are both Unix shells, but zsh offers more advanced features, such as better auto-completion, spelling correction, and plugin support.

Q4: How do I update my Flutter installation?

To update Flutter, run the following command in your terminal:

flutter upgrade

This will pull the latest version of the Flutter SDK and update your installation.

Q5: What other issues can cause the 'command not found: flutter' error?

If you've followed the steps above and still encounter the error, it could be due to an incorrect installation, file permissions issues, or other environment setup problems. To troubleshoot further, refer to the official Flutter documentation.

  1. Flutter Installation Guide
  2. Flutter Command Line Interface
  3. zsh Configuration Guide
  4. Flutter Troubleshooting Guide

Great! You’ve successfully signed up.

Welcome back! You've successfully signed in.

You've successfully subscribed to

Success! Check your email for magic link to sign-in.

Success! Your billing info has been updated.

Your billing was not updated.