跳转至正文

手动安装 Flutter

了解如何手动安装并配置 Flutter SDK。

了解如何手动安装并配置你的 Flutter 开发环境。

选择你的开发平台

#

本页说明默认针对在 Windows 设备上安装 Flutter。

若要查看其他操作系统的说明，请选择以下选项之一。

下载必备软件

#

在安装 Flutter SDK 之前，请先完成以下配置。

  1. 为 Windows 安装 Git

    下载并安装最新版本的 Git for Windows。

    有关安装或排查 Git 问题的帮助，请参阅 Git 文档。

  2. 配置编辑器或 IDE

    为获得最佳的 Flutter 应用开发体验，请考虑安装并配置 支持 Flutter 的编辑器或 IDE。

  1. 安装 Xcode 命令行工具

    下载 Xcode 命令行工具以获取 Flutter 依赖的命令行工具（包括 Git）。

    要下载这些工具，请在你偏好的终端中运行以下命令：

    xcode-select --install

    若你尚未安装这些工具，应会弹出对话框确认你是否要安装。点击 Install，安装完成后点击 Done。

  2. 配置编辑器或 IDE

    为获得最佳的 Flutter 应用开发体验，请考虑安装并配置 支持 Flutter 的编辑器或 IDE。

  1. 下载并安装必备 package

    使用你偏好的 package 管理器或安装方式，安装以下 package 的最新版本：

    • curl
    • git
    • unzip
    • xz-utils
    • zip
    • libglu1-mesa

    在基于 Debian 且使用 apt-get 的发行版（例如 Ubuntu）上，请使用以下命令安装这些 package：

    sudo apt-get update -y && sudo apt-get upgrade -y
sudo apt-get install -y curl git unzip xz-utils zip libglu1-mesa

  2. 配置编辑器或 IDE

    为获得最佳的 Flutter 应用开发体验，请考虑安装并配置 支持 Flutter 的编辑器或 IDE。

  1. 配置 Linux 支持

    若你此前未在 Chromebook 上配置 Linux 支持，请参阅 开启 Linux 支持。

    若你已开启 Linux 支持，请按照 修复 Linux 相关问题 的说明确保其为最新状态。

  2. 下载并安装必备 package

    使用 apt-get 或你偏好的安装方式，安装以下 package 的最新版本：

    • curl
    • git
    • unzip
    • xz-utils
    • zip
    • libglu1-mesa

    若要使用 apt-get，请使用以下命令安装这些 package：

    sudo apt-get update -y && sudo apt-get upgrade -y
sudo apt-get install -y curl git unzip xz-utils zip libglu1-mesa

  3. 配置编辑器或 IDE

    为获得最佳的 Flutter 应用开发体验，请考虑安装并配置 支持 Flutter 的编辑器或 IDE。

安装并配置 Flutter

#

要安装 Flutter SDK，请从 SDK 归档下载最新 bundle，然后将其解压到你希望存放的位置。

  1. 下载 Flutter SDK bundle

    下载以下安装 bundle 以获取 Flutter SDK 的最新稳定版。

    (加载中...)

  2. 创建用于存放 SDK 的文件夹

    创建或找到一个用于存放解压后 SDK 的文件夹。可考虑在 %USERPROFILE%\develop（C:\Users\{username}\develop）创建并使用该目录。

  3. 解压 SDK

    将你下载的 SDK bundle 解压到你希望存放 Flutter SDK 的目录。

    1. 复制以下命令。

    2. 将 <sdk_zip_path> 替换为你下载的 bundle 路径。

    3. 将 <destination_directory_path> 替换为你希望存放解压后 SDK 的文件夹路径。

    4. 在你偏好的终端中运行编辑后的命令。

    Expand-Archive –Path <sdk_zip_path> -Destination <destination_directory_path>

    例如，若你将 Flutter 3.29.3 的 bundle 下载到 %USERPROFILE%\Downloads 目录，并希望将解压后的 SDK 存放在 %USERPROFILE%\develop 目录：

    Expand-Archive `
  -Path $env:USERPROFILE\Downloads\flutter_windows_3.29.3-stable.zip `
  -Destination $env:USERPROFILE\develop\

  1. 下载 Flutter SDK bundle

    根据你的 macOS 设备的 CPU 架构，下载以下任一安装 bundle 以获取 Flutter SDK 的最新稳定版。

    | Apple Silicon (ARM64) | Intel |

    (加载中...)(加载中...)

  2. 创建用于存放 SDK 的文件夹

    创建或找到一个用于存放解压后 SDK 的文件夹。可考虑在 ~/develop/ 创建并使用该目录。

  3. 解压 SDK

    将你下载的 SDK bundle 解压到你希望存放 Flutter SDK 的目录。

    1. 复制以下命令。

    2. 将 <sdk_zip_path> 替换为你下载的 bundle 路径。

    3. 将 <destination_directory_path> 替换为你希望存放解压后 SDK 的文件夹路径。

    4. 在你偏好的终端中运行编辑后的命令。

    unzip <sdk_zip_path> -d <destination_directory_path>

    例如，若你将 Flutter 3.29.3 的 bundle 下载到 ~/Downloads 目录，并希望将解压后的 SDK 存放在 ~/develop 目录：

    unzip ~/Downloads/flutter_macos_3.29.3-stable.zip -d ~/develop/

  1. 下载 Flutter SDK bundle

    下载以下安装 bundle 以获取 Flutter SDK 的最新稳定版。

    (加载中...)

  2. 创建用于存放 SDK 的文件夹

    创建或找到一个用于存放解压后 SDK 的文件夹。可考虑在 ~/develop/ 创建并使用该目录。

  3. 解压 SDK

    将你下载的 SDK bundle 解压到你希望存放 Flutter SDK 的目录。

    1. 复制以下命令。

    2. 将 <sdk_zip_path> 替换为你下载的 bundle 路径。

    3. 将 <destination_directory_path> 替换为你希望存放解压后 SDK 的文件夹路径。

    4. 在你偏好的终端中运行编辑后的命令。

    tar -xf <sdk_zip_path> -C <destination_directory_path>

    例如，若你将 Flutter 3.29.3 的 bundle 下载到 ~/Downloads 目录，并希望将解压后的 SDK 存放在 ~/develop 目录：

    tar -xf ~/Downloads/flutter_linux_3.29.3-stable.tar.xz -C ~/develop/

将 Flutter 添加到 PATH

#

现在你已经下载了 SDK，请将 Flutter SDK 的 bin 目录添加到你的 PATH 环境变量。将 Flutter 添加到你的 PATH 后，你就可以在终端和 IDE 中使用 flutter 和 dart 命令行工具。

  1. Determine your Flutter SDK installation location

    Copy the absolute path to the directory that you downloaded and extracted the Flutter SDK into.

    1. 按下快捷键 Windows + Pause。

      如果你的键盘上没有 Pause 键，请尝试 Windows + Fn + B。

      这将会显示 系统 > 系统信息 的窗口。

    2. 单击 高级系统设置 > 高级 > 环境变量…

      这将会显示 环境变量 的窗口。

  3. Add the Flutter SDK bin to your path

    1. In the User variables for (username) section of the Environment Variables dialog, look for the Path entry.

    2. If the Path entry exists, double-click it.

      The Edit Environment Variable dialog should open.

      1. Double-click inside an empty row.

      2. Type the path to the bin directory of your Flutter installation.

        For example, if you downloaded Flutter into a develop\flutter folder inside your user directory, you'd type the following:

        %USERPROFILE%\develop\flutter\bin

      3. Click the Flutter entry you added to select it.

      4. Click Move Up until the Flutter entry sits at the top of the list.

      5. To confirm your changes, click OK three times.

    3. If the entry doesn't exist, click New....

      The Edit Environment Variable dialog should open.

      1. In the Variable Name box, type Path.

      2. In the Variable Value box, type the path to the bin directory of your Flutter installation.

        For example, if you downloaded Flutter into a develop\flutter folder inside your user directory, you'd type the following:

        %USERPROFILE%\develop\flutter\bin

      3. To confirm your changes, click OK three times.

  4. Apply your changes

    To apply this change and get access to the flutter tool, close and reopen all open command prompts, sessions in your terminal apps, and IDEs.

  5. Validate your setup

    To ensure you successfully added the SDK to your PATH, open command prompt or your preferred terminal app, then try running the flutter and dart tools.

    flutter --version
dart --version

    If either command isn't found, check out Flutter installation troubleshooting.

  1. 确定 Flutter SDK 安装位置

    复制你下载并解压 Flutter SDK 所在目录的绝对路径。

  2. 打开或创建 Zsh 环境变量文件

    若存在，请在你偏好的文本编辑器中打开 Zsh 环境变量文件 ~/.zprofile。若不存在，请创建 ~/.zprofile 文件。

  3. 将 Flutter SDK 的 bin 添加到你的 PATH

    在 ~/.zprofile 文件末尾，使用内置 export 命令更新 PATH 变量，使其包含 Flutter 安装目录下的 bin。

    将 <path-to-sdk> 替换为你的 Flutter SDK 安装路径。

    bash
    export PATH="<path-to-sdk>/bin:$PATH"

    例如，若你将 Flutter 下载到用户目录下的 develop/flutter 文件夹，可向文件添加：

    bash
    export PATH="$HOME/develop/flutter/bin:$PATH"

  4. 保存你的更改

    保存并关闭你编辑的 ~/.zprofile 文件。

  5. 应用你的更改

    要应用此更改并访问 flutter 工具，请在终端应用和 IDE 中关闭并重新打开所有已打开的 Zsh 会话。

  6. 验证你的配置

    为确保你已成功将 SDK 添加到 PATH，请在你偏好的终端中打开 Zsh 会话，然后尝试运行 flutter 和 dart 工具。

    flutter --version
dart --version

    若任一命令未找到，请参阅 Flutter 安装问题排查。

  1. 确定 Flutter SDK 安装位置

    复制你下载并解压 Flutter SDK 所在目录的绝对路径。

  2. 确定你的默认 shell

    若你不确定自己使用哪种 shell，可查看打开新控制台窗口时启动的是哪一种。

    echo $SHELL

  3. 将 Flutter SDK 的 bin 添加到你的 PATH

    要将 Flutter 安装目录下的 bin 添加到 PATH：

    1. Expand the instructions for your default shell.
    2. 展开与你默认 shell 对应的说明。
    3. Copy the provided command.
    4. 复制提供的命令。
    5. Replace <path-to-sdk> with the path to your Flutter SDK install.
    6. 将 <path-to-sdk> 替换为你的 Flutter SDK 安装路径。
    7. Run the edited command in your preferred terminal with that shell.
    8. 在使用该 shell 的你偏好的终端中运行编辑后的命令。
    Expand for bash instructions
    展开 bash 相关说明
    echo 'export PATH="<path-to-sdk>/bin:$PATH"' >> ~/.bashrc

    例如，若你将 Flutter 下载到用户目录下的 develop/flutter 文件夹，可运行：

    echo 'export PATH="$HOME/develop/flutter/bin:$PATH"' >> ~/.bashrc
    Expand for zsh instructions
    展开 zsh 相关说明
    echo 'export PATH="<path-to-sdk>/bin:$PATH"' >> ~/.zshenv

    例如，若你将 Flutter 下载到用户目录下的 develop/flutter 文件夹，可运行：

    echo 'export PATH="$HOME/develop/flutter/bin:$PATH"' >> ~/.zshenv
    Expand for fish instructions
    展开 fish 相关说明
    fish_add_path -g -p <path-to-sdk>/bin

    例如，若你将 Flutter 下载到用户目录下的 develop/flutter 文件夹，可运行：

    fish_add_path -g -p ~/develop/flutter/bin
    Expand for csh instructions
    展开 csh 相关说明
    echo 'setenv PATH "<path-to-sdk>/bin:$PATH"' >> ~/.cshrc

    例如，若你将 Flutter 下载到用户目录下的 develop/flutter 文件夹，可运行：

    echo 'setenv PATH "$HOME/develop/flutter/bin:$PATH"' >> ~/.cshrc
    Expand for tcsh instructions
    展开 tcsh 相关说明
    echo 'setenv PATH "<path-to-sdk>/bin:$PATH"' >> ~/.tcshrc

    例如，若你将 Flutter 下载到用户目录下的 develop/flutter 文件夹，可运行：

    echo 'setenv PATH "$HOME/develop/flutter/bin:$PATH"' >> ~/.tcshrc
    Expand for ksh instructions
    展开 ksh 相关说明
    echo 'export PATH="<path-to-sdk>/bin:$PATH"' >> ~/.profile

    例如，若你将 Flutter 下载到用户目录下的 develop/flutter 文件夹，可运行：

    echo 'export PATH="$HOME/develop/flutter/bin:$PATH"' >> ~/.profile
    Expand for sh instructions
    展开 sh 相关说明
    echo 'export PATH="<path-to-sdk>/bin:$PATH"' >> ~/.profile

    例如，若你将 Flutter 下载到用户目录下的 develop/flutter 文件夹，可运行：

    echo 'export PATH="$HOME/develop/flutter/bin:$PATH"' >> ~/.profile

  4. 应用你的更改

    要应用此更改并访问 flutter 工具，请在终端应用和 IDE 中关闭并重新打开所有已打开的 shell 会话。

  5. 验证你的配置

    为确保你已成功将 SDK 添加到 PATH，请使用默认 shell 打开你偏好的终端，然后尝试运行 flutter 和 dart 工具。

    flutter --version
dart --version

    若任一命令未找到，请参阅 Flutter 安装问题排查。

  1. 确定 Flutter SDK 安装位置

    复制你下载并解压 Flutter SDK 所在目录的绝对路径。

  2. 将 Flutter SDK 的 bin 添加到你的 PATH

    要将 Flutter 安装目录下的 bin 添加到 PATH：

    1. Copy the following command.
    2. 复制以下命令。
    3. Replace <path-to-sdk> with the path to your Flutter SDK install.
    4. 将 <path-to-sdk> 替换为你的 Flutter SDK 安装路径。
    5. Run the edited command in your preferred terminal.
    6. 在你偏好的终端中运行编辑后的命令。
    echo 'export PATH="<path-to-sdk>:$PATH"' >> ~/.bash_profile

    例如，若你将 Flutter 下载到用户目录下的 develop/flutter 文件夹，可运行：

    echo 'export PATH="$HOME/develop/flutter/bin:$PATH"' >> ~/.bash_profile

  3. 应用你的更改

    要应用此更改并访问 flutter 工具，请在终端应用和 IDE 中关闭并重新打开所有已打开的 Zsh 会话。

  4. 验证你的配置

    为确保你已成功将 SDK 添加到 PATH，请在你偏好的终端中打开 Zsh 会话，然后尝试运行 flutter 和 dart 工具。

    flutter --version
dart --version

    若任一命令未找到，请参阅 Flutter 安装问题排查。

继续你的 Flutter 之旅

#

现在你已经成功安装了 Flutter，请至少为一个目标平台配置开发环境，以继续你的 Flutter 学习之旅。

配置目标平台
学习 Flutter 开发
跟进 Flutter 最新动态

除非另有说明，本文档之所提及适用于 Flutter 3.44.0 版本。本页面最后更新时间：2026-06-04。查看文档源码 或者 为本页面内容提出建议。