了解如何手动安装和设置 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) 部分,查找 Path 条目。

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

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

      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 之旅。