了解如何安装和手动设置您的 Flutter 开发环境。

选择您的开发平台

#

本页说明旨在涵盖在 Windows 设备上安装 Flutter 的过程。

如果您想遵循适用于不同操作系统的说明,请选择以下一项。

下载先决软件

#

在安装 Flutter SDK 之前,请先完成以下设置。

  1. 安装适用于 Windows 的 Git

    下载并安装最新版适用于 Windows 的 Git

    如需安装或排查 Git 的帮助,请参考Git 文档

  2. 设置编辑器或 IDE

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

  1. 安装 Xcode 命令行工具

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

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

    xcode-select --install

    如果您尚未安装这些工具,将弹出一个对话框,确认您是否要安装它们。点击安装,待安装完成后,点击完成

  2. 设置编辑器或 IDE

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

  1. 下载并安装必备软件包

    使用您偏好的软件包管理器或机制,安装以下软件包的最新版本

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

    在基于 Debian 的发行版(如 Ubuntu)上,使用 apt-get 通过以下命令安装这些软件包

    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. 下载并安装必备软件包

    使用 apt-get 或您偏好的安装机制,安装以下软件包的最新版本

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

    如果您想使用 apt-get,请使用以下命令安装这些软件包

    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 存档下载最新捆绑包,然后将 SDK 解压到您希望存储的位置。

  1. 下载 Flutter SDK 捆绑包

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

    (加载中...)

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

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

  3. 解压 SDK

    将您下载的 SDK 捆绑包解压到您希望存储 Flutter SDK 的目录中。

    1. 复制以下命令。
    2. <sdk_zip_path> 替换为您下载的捆绑包路径。
    3. <destination_directory_path> 替换为存放解压后的 SDK 的文件夹路径。
    4. 在您偏好的终端中运行编辑后的命令。
    Expand-Archive –Path <sdk_zip_path> -Destination <destination_directory_path>

    例如,如果您将 Flutter 3.29.3 的捆绑包下载到 %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 捆绑包

    根据您的 macOS 设备的 CPU 架构,下载以下安装捆绑包之一以获取 Flutter SDK 的最新稳定版本。

    Apple Silicon (ARM64)Intel (x64)
    (加载中...)(加载中...)
  2. 创建用于存储 SDK 的文件夹

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

  3. 解压 SDK

    将您下载的 SDK 捆绑包解压到您希望存储 Flutter SDK 的目录中。

    1. 复制以下命令。
    2. <sdk_zip_path> 替换为您下载的捆绑包路径。
    3. <destination_directory_path> 替换为存放解压后的 SDK 的文件夹路径。
    4. 在您偏好的终端中运行编辑后的命令。
    unzip <sdk_zip_path> -d <destination_directory_path>

    例如,如果您将 Flutter 3.29.3 的捆绑包下载到 ~/Downloads 目录,并希望将解压后的 SDK 存储在 ~/develop 目录中

    unzip ~/Downloads/flutter_macos_3.29.3-stable.zip -d ~/develop/
  1. 下载 Flutter SDK 捆绑包

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

    (加载中...)

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

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

  3. 解压 SDK

    将您下载的 SDK 捆绑包解压到您希望存储 Flutter SDK 的目录中。

    1. 复制以下命令。
    2. <sdk_zip_path> 替换为您下载的捆绑包路径。
    3. <destination_directory_path> 替换为存放解压后的 SDK 的文件夹路径。
    4. 在您偏好的终端中运行编辑后的命令。
    tar -xf <sdk_zip_path> -C <destination_directory_path>

    例如,如果您将 Flutter 3.29.3 的捆绑包下载到 ~/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 中使用 flutterdart 命令行工具。

  1. 确定您的 Flutter SDK 安装位置

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

  2. 导航到环境变量设置

    1. 按下 Windows + Pause

      如果您的键盘没有 Pause 键,请尝试 Windows + Fn + B

      系统 > 关于 对话框打开。

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

      环境变量 对话框打开。

  3. 将 Flutter SDK 的 bin 目录添加到您的路径

    1. 环境变量对话框的用户变量 (username) 部分,查找路径条目。

    2. 如果路径条目存在,双击它。

      编辑环境变量 对话框应该打开。

      1. 双击空白行。

      2. 输入您的 Flutter 安装目录中 bin 目录的路径。

        例如,如果您将 Flutter 下载到用户目录中的 develop\flutter 文件夹,您将输入以下内容

        %USERPROFILE%\develop\flutter\bin
      3. 点击您添加的 Flutter 条目以选中它。

      4. 点击上移,直到 Flutter 条目位于列表顶部。

      5. 要确认您的更改,请点击三次确定

    3. 如果该条目不存在,请点击新建...

      编辑环境变量 对话框应该打开。

      1. 在“变量名”框中,输入 Path

      2. 变量值框中,输入您的 Flutter 安装目录中 bin 目录的路径。

        例如,如果您将 Flutter 下载到用户目录中的 develop\flutter 文件夹,您将输入以下内容

        %USERPROFILE%\develop\flutter\bin
      3. 要确认您的更改,请点击三次确定

  4. 应用您的更改

    要应用此更改并访问 flutter 工具,请关闭并重新打开所有打开的命令提示符、终端应用程序中的会话以及 IDE。

  5. 验证您的设置

    为确保您已成功将 SDK 添加到 PATH,请打开命令提示符或您偏好的终端应用程序,然后尝试运行 flutterdart 工具。

    flutter --version
    dart --version

    如果任何命令未找到,请查看Flutter 安装故障排除

  1. 确定您的 Flutter SDK 安装位置

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

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

    如果存在,请在您偏好的文本编辑器中打开 Zsh 环境变量文件 ~/.zshenv。如果不存在,请创建 ~/.zshenv 文件。

  3. 将 Flutter SDK 的 bin 目录添加到您的路径

    在您的 ~/.zshenv 文件末尾,使用内置的 export 命令更新 PATH 变量,以包含您的 Flutter 安装目录中的 bin 目录。

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

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

    例如,如果您将 Flutter 下载到用户目录中的 development/flutter 文件夹,您将把以下内容添加到文件中

    bash
    export PATH="$HOME/development/flutter/bin:$PATH"
  4. 保存您的更改

    保存并关闭您编辑的 ~/.zshenv 文件。

  5. 应用您的更改

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

  6. 验证您的设置

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

    flutter --version
    dart --version

    如果任何命令未找到,请查看Flutter 安装故障排除

  1. 确定您的 Flutter SDK 安装位置

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

  2. 确定您的默认 shell

    如果您不知道使用哪个 shell,请在新控制台窗口打开时检查哪个 shell 启动。

    echo $SHELL
  3. 将 Flutter SDK 的 bin 目录添加到您的路径

    要将您的 Flutter 安装目录中的 bin 目录添加到您的 PATH

    1. 展开您默认 shell 的说明。
    2. 复制提供的命令。
    3. <path-to-sdk> 替换为您的 Flutter SDK 安装路径。
    4. 在该 shell 中运行您偏好的终端中编辑后的命令。

    展开 bash 说明
    echo 'export PATH="<path-to-sdk>:$PATH"' >> ~/.bash_profile

    例如,如果您将 Flutter 下载到用户目录中的 development/flutter 文件夹,您将运行以下内容

    echo 'export PATH="$HOME/development/flutter/bin:$PATH"' >> ~/.bash_profile
    展开 zsh 说明
    echo 'export PATH="<path-to-sdk>/bin:$PATH"' >> ~/.zshenv

    例如,如果您将 Flutter 下载到用户目录中的 development/flutter 文件夹,您将运行以下内容

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

    例如,如果您将 Flutter 下载到用户目录中的 development/flutter 文件夹,您将运行以下内容

    fish_add_path -g -p ~/development/flutter/bin
    展开 csh 说明
    echo 'setenv PATH "<path-to-sdk>/bin:$PATH"' >> ~/.cshrc

    例如,如果您将 Flutter 下载到用户目录中的 development/flutter 文件夹,您将运行以下内容

    echo 'setenv PATH "$HOME/development/flutter/bin:$PATH"' >> ~/.cshrc
    展开 tcsh 说明
    echo 'setenv PATH "<path-to-sdk>/bin:$PATH"' >> ~/.tcshrc

    例如,如果您将 Flutter 下载到用户目录中的 development/flutter 文件夹,您将运行以下内容

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

    例如,如果您将 Flutter 下载到用户目录中的 development/flutter 文件夹,您将运行以下内容

    echo 'export PATH="$HOME/development/flutter/bin:$PATH"' >> ~/.profile
    展开 sh 说明
    echo 'export PATH="<path-to-sdk>/bin:$PATH"' >> ~/.profile

    例如,如果您将 Flutter 下载到用户目录中的 development/flutter 文件夹,您将运行以下内容

    echo 'export PATH="$HOME/development/flutter/bin:$PATH"' >> ~/.profile
  4. 应用您的更改

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

  5. 验证您的设置

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

    flutter --version
    dart --version

    如果任何命令未找到,请查看Flutter 安装故障排除

  1. 确定您的 Flutter SDK 安装位置

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

  2. 将 Flutter SDK 的 bin 目录添加到您的路径

    要将您的 Flutter 安装目录中的 bin 目录添加到您的 PATH

    1. 复制以下命令。
    2. <path-to-sdk> 替换为您的 Flutter SDK 安装路径。
    3. 在您偏好的终端中运行编辑后的命令。
    echo 'export PATH="<path-to-sdk>:$PATH"' >> ~/.bash_profile

    例如,如果您将 Flutter 下载到用户目录中的 development/flutter 文件夹,您将运行以下内容

    echo 'export PATH="$HOME/development/flutter/bin:$PATH"' >> ~/.bash_profile
  3. 应用您的更改

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

  4. 验证您的设置

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

    flutter --version
    dart --version

    如果任何命令未找到,请查看Flutter 安装故障排除

继续您的 Flutter 之旅

#

现在您已成功安装 Flutter,请为至少一个目标平台设置开发环境,以继续您的 Flutter 之旅。