跳到主内容

手动安装 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 存档下载最新的软件包,然后将 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
    (加载中...)(加载中...)
  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 之旅。