跳到主内容

手动安装 Flutter

了解如何手动安装和设置 Flutter SDK。

了解如何手动安装和配置您的 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 存档中下载最新的压缩包,然后将其解压到您希望存放的位置。

  1. 下载 Flutter SDK 压缩包

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

    (加载中...)
  2. 创建一个文件夹以存放 SDK

    创建或找一个文件夹来存放解压后的 SDK。建议在 %USERPROFILE%\develop (C:\Users\{用户名}\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
    (加载中...)(加载中...)
  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. 环境变量对话框的(用户名)的用户变量部分中,找到 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 环境变量文件 ~/.zprofile。如果不存在,请创建 ~/.zprofile 文件。

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

    ~/.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 会话,然后尝试运行 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>/bin:$PATH"' >> ~/.bashrc
    

    例如,如果您将 Flutter 下载到用户目录下的 develop/flutter 文件夹中,则需要运行以下命令

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

    例如,如果您将 Flutter 下载到用户目录下的 develop/flutter 文件夹中,则需要运行以下命令

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

    例如,如果您将 Flutter 下载到用户目录下的 develop/flutter 文件夹中,则需要运行以下命令

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

    例如,如果您将 Flutter 下载到用户目录下的 develop/flutter 文件夹中,则需要运行以下命令

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

    例如,如果您将 Flutter 下载到用户目录下的 develop/flutter 文件夹中,则需要运行以下命令

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

    例如,如果您将 Flutter 下载到用户目录下的 develop/flutter 文件夹中,则需要运行以下命令

    echo 'export PATH="$HOME/develop/flutter/bin:$PATH"' >> ~/.profile
    
    展开查看 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 打开您首选的终端,然后尝试运行 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 下载到用户目录下的 develop/flutter 文件夹中,则需要运行以下命令

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

    要应用此更改并获得对 flutter 工具的访问权限,请关闭并重新打开终端应用和 IDE 中所有已开启的 Zsh 会话。

  4. 验证您的设置

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

    flutter --version
    dart --version
    

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

继续你的 Flutter 之旅

#

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