手动安装 Flutter
了解如何手动安装和设置 Flutter SDK。
了解如何手动安装和配置您的 Flutter 开发环境。
选择你的开发平台
#本页面上的说明适用于在 Windows 设备上安装 Flutter。
如果你想遵循其他操作系统的说明,请选择以下之一。
下载先决软件
#在安装 Flutter SDK 之前,请先完成以下设置。
-
安装适用于 Windows 的 Git
下载并安装最新版适用于 Windows 的 Git。
有关安装或故障排除 Git 的帮助,请参阅 Git 文档。
-
设置编辑器或 IDE
为了获得最佳的 Flutter 应用开发体验,请考虑安装并配置一个支持 Flutter 的编辑器或 IDE。
-
安装 Xcode 命令行工具
下载 Xcode 命令行工具以访问 Flutter 依赖的命令行工具,包括 Git。
要下载这些工具,请在你喜欢的终端中运行以下命令
xcode-select --install如果你尚未安装这些工具,将弹出一个对话框,确认你是否要安装它们。单击 安装,安装完成后,单击 完成。
-
设置编辑器或 IDE
为了获得最佳的 Flutter 应用开发体验,请考虑安装并配置一个支持 Flutter 的编辑器或 IDE。
-
下载并安装先决软件包
使用你偏好的包管理器或机制,安装以下软件包的最新版本
curlgitunzipxz-utilsziplibglu1-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 -
设置编辑器或 IDE
为了获得最佳的 Flutter 应用开发体验,请考虑安装并配置一个支持 Flutter 的编辑器或 IDE。
-
设置 Linux 支持
如果你之前未在 Chromebook 上设置 Linux 支持,请开启 Linux 支持。
如果你已经开启了 Linux 支持,请按照解决 Linux 问题的说明进行更新。
-
下载并安装先决软件包
使用
apt-get或你喜欢的安装机制,安装以下软件包的最新版本curlgitunzipxz-utilsziplibglu1-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 -
设置编辑器或 IDE
为了获得最佳的 Flutter 应用开发体验,请考虑安装并配置一个支持 Flutter 的编辑器或 IDE。
安装并设置 Flutter
#要安装 Flutter SDK,请从 SDK 存档中下载最新的压缩包,然后将其解压到您希望存放的位置。
-
下载 Flutter SDK 压缩包
下载以下安装包以获取 Flutter SDK 的最新稳定版本。
(加载中...) -
创建一个文件夹以存放 SDK
创建或找一个文件夹来存放解压后的 SDK。建议在
%USERPROFILE%\develop(C:\Users\{用户名}\develop) 目录下创建并使用该文件夹。 -
解压 SDK
将您下载的 SDK 压缩包解压到您希望存放 Flutter SDK 的目录中。
- 复制以下命令。
- 将
<sdk_zip_path>替换为您下载的压缩包路径。 - 将
<destination_directory_path>替换为您希望存放解压后 SDK 的文件夹路径。 - 在您首选的终端中运行编辑后的命令。
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\
-
下载 Flutter SDK 压缩包
根据您 macOS 设备的 CPU 架构,下载以下安装包之一以获取 Flutter SDK 的最新稳定版本。
-
创建一个文件夹以存放 SDK
创建或找一个文件夹来存放解压后的 SDK。建议在
~/develop/目录下创建并使用该文件夹。 -
解压 SDK
将您下载的 SDK 压缩包解压到您希望存放 Flutter SDK 的目录中。
- 复制以下命令。
- 将
<sdk_zip_path>替换为您下载的压缩包路径。 - 将
<destination_directory_path>替换为您希望存放解压后 SDK 的文件夹路径。 - 在您首选的终端中运行编辑后的命令。
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/
-
下载 Flutter SDK 压缩包
下载以下安装包以获取 Flutter SDK 的最新稳定版本。
(加载中...) -
创建一个文件夹以存放 SDK
创建或找一个文件夹来存放解压后的 SDK。建议在
~/develop/目录下创建并使用该文件夹。 -
解压 SDK
将您下载的 SDK 压缩包解压到您希望存放 Flutter SDK 的目录中。
- 复制以下命令。
- 将
<sdk_zip_path>替换为您下载的压缩包路径。 - 将
<destination_directory_path>替换为您希望存放解压后 SDK 的文件夹路径。 - 在您首选的终端中运行编辑后的命令。
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 中使用 flutter 和 dart 命令行工具了。
-
确定您的 Flutter SDK 安装位置
复制您下载并解压 Flutter SDK 的目录的绝对路径。
-
导航到环境变量设置
按下 Windows + Pause。
如果您的键盘没有 Pause 键,请尝试 Windows + Fn + B。
此时将打开系统 > 关于对话框。
点击高级系统设置 > 高级 > 环境变量...。
此时将打开环境变量对话框。
-
将 Flutter SDK bin 添加到您的路径
在环境变量对话框的(用户名)的用户变量部分中,找到 Path 条目。
如果存在 Path 条目,请双击它。
此时应打开编辑环境变量对话框。
双击空白行。
输入您的 Flutter 安装目录中
bin文件夹的路径。例如,如果您将 Flutter 下载到用户目录下的
develop\flutter文件夹中,则需要输入以下内容%USERPROFILE%\develop\flutter\bin点击您添加的 Flutter 条目以选中它。
点击上移,直到 Flutter 条目位于列表顶部。
要确认更改,请连续点击三次确定。
如果该条目不存在,请点击新建...。
此时应打开编辑环境变量对话框。
在“变量名”框中,输入
Path。在变量值框中,输入您的 Flutter 安装目录中
bin文件夹的路径。例如,如果您将 Flutter 下载到用户目录下的
develop\flutter文件夹中,则需要输入以下内容%USERPROFILE%\develop\flutter\bin要确认更改,请连续点击三次确定。
-
应用您的更改
要应用此更改并获得对
flutter工具的访问权限,请关闭并重新打开所有已开启的命令提示符、终端应用会话以及 IDE。 -
验证您的设置
要确保已成功将 SDK 添加到
PATH,请打开命令提示符或您首选的终端应用,然后尝试运行flutter和dart工具。flutter --version dart --version如果找不到任一命令,请查看Flutter 安装故障排除。
-
确定您的 Flutter SDK 安装位置
复制您下载并解压 Flutter SDK 的目录的绝对路径。
-
打开或创建 Zsh 环境变量文件
如果存在,请在您首选的文本编辑器中打开 Zsh 环境变量文件
~/.zprofile。如果不存在,请创建~/.zprofile文件。 -
将 Flutter SDK bin 添加到您的路径
在
~/.zprofile文件的末尾,使用内置的export命令更新PATH变量,以包含 Flutter 安装目录中的bin目录。将
<path-to-sdk>替换为您 Flutter SDK 的安装路径。bashexport PATH="<path-to-sdk>/bin:$PATH"例如,如果您将 Flutter 下载到用户目录下的
develop/flutter文件夹中,则需要在文件中添加以下内容bashexport PATH="$HOME/develop/flutter/bin:$PATH" 保存更改
保存并关闭您编辑的
~/.zprofile文件。-
应用您的更改
要应用此更改并获得对
flutter工具的访问权限,请关闭并重新打开终端应用和 IDE 中所有已开启的 Zsh 会话。 -
验证您的设置
要确保已成功将 SDK 添加到
PATH,请在您首选的终端中打开 Zsh 会话,然后尝试运行flutter和dart工具。flutter --version dart --version如果找不到任一命令,请查看Flutter 安装故障排除。
-
确定您的 Flutter SDK 安装位置
复制您下载并解压 Flutter SDK 的目录的绝对路径。
-
确定您的默认 shell
如果您不知道自己使用的 shell,请查看打开新的控制台窗口时启动的是哪个 shell。
echo $SHELL -
将 Flutter SDK bin 添加到您的路径
要将 Flutter 安装目录的
bin目录添加到PATH- 展开适用于您默认 shell 的说明。
- 复制提供的命令。
- 将
<path-to-sdk>替换为您 Flutter SDK 的安装路径。 - 在您使用该 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 -
应用您的更改
要应用此更改并获得对
flutter工具的访问权限,请关闭并重新打开终端应用和 IDE 中所有已开启的 shell 会话。 -
验证您的设置
要确保已成功将 SDK 添加到
PATH,请使用您的默认 shell 打开您首选的终端,然后尝试运行flutter和dart工具。flutter --version dart --version如果找不到任一命令,请查看Flutter 安装故障排除。
-
确定您的 Flutter SDK 安装位置
复制您下载并解压 Flutter SDK 的目录的绝对路径。
-
将 Flutter SDK bin 添加到您的路径
要将 Flutter 安装目录的
bin目录添加到PATH- 复制以下命令。
- 将
<path-to-sdk>替换为您 Flutter SDK 的安装路径。 - 在您首选的终端中运行编辑后的命令。
echo 'export PATH="<path-to-sdk>:$PATH"' >> ~/.bash_profile例如,如果您将 Flutter 下载到用户目录下的
develop/flutter文件夹中,则需要运行以下命令echo 'export PATH="$HOME/develop/flutter/bin:$PATH"' >> ~/.bash_profile -
应用您的更改
要应用此更改并获得对
flutter工具的访问权限,请关闭并重新打开终端应用和 IDE 中所有已开启的 Zsh 会话。 -
验证您的设置
要确保已成功将 SDK 添加到
PATH,请在您首选的终端中打开 Zsh 会话,然后尝试运行flutter和dart工具。flutter --version dart --version如果找不到任一命令,请查看Flutter 安装故障排除。
继续你的 Flutter 之旅
#现在您已经成功安装了 Flutter,请至少设置一个目标平台的开发环境,以继续您的 Flutter 之旅。